diff --git a/.github/workflows/pr-version-check.yml b/.github/workflows/pr-version-check.yml new file mode 100644 index 0000000..1cbf871 --- /dev/null +++ b/.github/workflows/pr-version-check.yml @@ -0,0 +1,43 @@ +name: PR Version Check + +on: + pull_request: + branches: + - main + types: [opened, synchronize] + +jobs: + version-check: + runs-on: ubuntu-latest + steps: + - name: Checkout PR branch + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Get PR branch package.json version + id: pr-version + run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT + + - name: Get main branch package.json version + id: main-version + run: | + git checkout main + echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT + + - name: Compare versions + run: | + PR_VERSION="${{ steps.pr-version.outputs.version }}" + MAIN_VERSION="${{ steps.main-version.outputs.version }}" + + echo "PR branch version: $PR_VERSION" + echo "Main branch version: $MAIN_VERSION" + + if [ "$PR_VERSION" = "$MAIN_VERSION" ]; then + echo "❌ Version must be updated in package.json" + echo "Current version: $MAIN_VERSION" + echo "Please increment the version number before merging to main" + exit 1 + else + echo "✅ Version has been updated from $MAIN_VERSION to $PR_VERSION" + fi \ No newline at end of file diff --git a/README.md b/README.md index 4a1b760..abe6e84 100644 --- a/README.md +++ b/README.md @@ -158,9 +158,11 @@ The {{siteName}} Team ## Advanced Features -### Email Wrapper Hook +### Custom HTML Layouts with Email Wrapper Hook -Use the `emailWrapper` hook to apply consistent layouts to all emails: +The `emailWrapper` hook allows you to apply consistent HTML layouts and styling to all emails sent through the plugin. This is perfect for adding company branding, headers, footers, and responsive styling. + +#### Basic Email Wrapper ```typescript mailingPlugin({ @@ -171,13 +173,20 @@ mailingPlugin({ + ${email.subject} @@ -189,7 +198,9 @@ mailingPlugin({ ${email.html}
- © 2024 My Company. All rights reserved. + © 2024 My Company. All rights reserved.
+ Unsubscribe | + Contact Support
@@ -199,12 +210,230 @@ mailingPlugin({ return { ...email, html: wrappedHtml, - text: `MY COMPANY\n\n${email.text}\n\n© 2024 My Company` + text: `MY COMPANY\n\n${email.text}\n\n© 2024 My Company\nUnsubscribe: [link] | Contact Support: [link]` } } }) ``` +#### Advanced Email Wrapper with Dynamic Content + +```typescript +mailingPlugin({ + // ... other config + emailWrapper: (email) => { + // You can access email properties and customize based on content + const isTransactional = email.subject?.includes('Receipt') || email.subject?.includes('Confirmation'); + const headerColor = isTransactional ? '#28a745' : '#007bff'; + const headerText = isTransactional ? 'Order Confirmation' : 'My Company'; + + const wrappedHtml = ` + + + + + + + ${email.subject} + + + + +
+
+

${headerText}

+
+
+ ${email.html} +
+
+

© ${new Date().getFullYear()} My Company. All rights reserved.

+

+ Contact Support | + Privacy Policy | + Unsubscribe +

+
+
+ + + ` + + // Also enhance the plain text version + const wrappedText = ` +${headerText.toUpperCase()} +${'='.repeat(headerText.length)} + +${email.text || email.html?.replace(/<[^>]*>/g, '')} + +--- +© ${new Date().getFullYear()} My Company. All rights reserved. +Contact Support: support@mycompany.com +Privacy Policy: [link] +Unsubscribe: [link] + `.trim(); + + return { + ...email, + html: wrappedHtml, + text: wrappedText + } + } +}) +``` + +#### External CSS and Assets + +You can also reference external stylesheets and assets: + +```typescript +mailingPlugin({ + emailWrapper: (email) => { + const wrappedHtml = ` + + + + + + ${email.subject} + + + + + +
+ My Company +
+ ${email.html} +
+ Footer +
+ + + `; + + return { ...email, html: wrappedHtml }; + } +}) +``` + +#### Template-Specific Layouts + +You can customize layouts based on email templates: + +```typescript +mailingPlugin({ + emailWrapper: (email, context) => { + // Access template information if available + const templateSlug = context?.templateSlug; + + let layoutClass = 'default-layout'; + let headerColor = '#007bff'; + + if (templateSlug === 'welcome-email') { + layoutClass = 'welcome-layout'; + headerColor = '#28a745'; + } else if (templateSlug === 'invoice-email') { + layoutClass = 'invoice-layout'; + headerColor = '#dc3545'; + } + + const wrappedHtml = ` + + + + + ${email.subject} + + + +
+ ${email.html} +
+ + + `; + + return { ...email, html: wrappedHtml }; + } +}) +``` + +The `emailWrapper` hook receives the email object with `html`, `text`, and `subject` properties, and should return the modified email object with your custom layout applied. + ### Custom Rich Text Editor Override the rich text editor used for templates: diff --git a/package.json b/package.json index 2f3f60b..e9ef4b7 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@xtr-dev/payload-mailing", - "version": "0.0.2", + "version": "0.0.3", "description": "Template-based email system with scheduling and job processing for PayloadCMS", "type": "module", "main": "dist/index.js",