ima-claude 2.15.0 → 2.16.0

package/plugins/ima-claude/skills/ima-email-creator/references/wp-transactional.md

@@ -0,0 +1,77 @@
+# PHP Email Template Patterns for WordPress
+
+## Architecture: Pure Function + WordPress Wrapper
+
+The IMA codebase separates email generation from sending:
+- **Pure functions** generate HTML/text with zero WordPress dependencies (testable)
+- **WordPress wrappers** handle side effects (wp_mail, user lookups, logging)
+
+## Brand Alignment Note
+
+WordPress transactional emails use the **ima-brand plugin colors**: `#00066F` Indigo headers, `#00B8B8` Aquatic Pulse CTAs, `#494949` Gravel text — applied via `ima_brand_email_wrapper()`.
+
+Marketing emails (BeeFree/EspoCRM drip and campaign) are now aligned to the same brand book colors: `#00B8B8` Aquatic Pulse CTAs, `#494949` Gravel text — replacing the old `#0296a1`/`#374751` palette. The only distinction is that transactional emails also use `#00066F` Indigo for headers (via `ima_brand_email_wrapper()`), which marketing email templates handle in their own header blocks.
+
+## The Brand Wrapper
+
+`ima_brand_email_wrapper()` from `ima-brand` plugin provides:
+- Consistent outer HTML structure (header with logo, footer)
+- Brand colors and typography
+- Location: `wp-content/plugins/ima-brand/includes/email-template.php`
+
+```php
+$html = ima_brand_email_wrapper($inner_html, $subject);
+```
+
+## Pure Template Pattern
+
+```php
+// inc/pure/email-templates.php
+declare(strict_types=1);
+
+function ima_build_invitation_email(array $data): string {
+    // Pure function — no WordPress calls, no side effects
+    $name = htmlspecialchars($data['name'], ENT_QUOTES, 'UTF-8');
+    // ... build HTML with inline styles ...
+    return $html;
+}
+```
+
+## WordPress Wrapper Pattern
+
+```php
+// inc/invitation-emails.php
+function ima_send_invitation_email(int $user_id, string $code): bool {
+    $user = get_userdata($user_id);
+    $html = ima_build_invitation_email([
+        'name' => $user->display_name,
+        'code' => $code,
+    ]);
+    $wrapped = ima_brand_email_wrapper($html, 'Your Invitation');
+    return wp_mail($user->user_email, 'Your Invitation', $wrapped, [
+        'Content-Type: text/html; charset=UTF-8',
+    ]);
+}
+```
+
+## Existing Email Modules
+
+| Module | Location | Purpose |
+|--------|----------|---------|
+| Invitations | child theme `inc/pure/email-templates.php` | Invitation, activation, application emails |
+| Payments | `ima-payments` plugin | Receipt emails with PDF attachments |
+| Memberships | `ima-memberships` plugin | Retention and welcome emails |
+| Registration | `ima-registration` plugin | Email verification codes |
+| Contact forms | `ima-forms` plugin | Form submission notifications |
+
+## Key Rules
+
+- Always escape: `htmlspecialchars($value, ENT_QUOTES, 'UTF-8')`
+- Set content type header: `Content-Type: text/html; charset=UTF-8`
+- Use `do_action('ima_log_info', 'Email sent to: ' . $email)` for logging
+- Plain text fallback via `wp_mail` multipart (optional but good practice)
+
+## When to Use This vs. Newsletter/Campaign
+
+- **This pattern**: System-triggered emails (verification, receipts, notifications) — lives in PHP, runs in WordPress
+- **Newsletter/Campaign**: Marketing emails created in Claude, pasted into EspoCRM — platform-agnostic HTML

package/plugins/ima-claude/skills/ima-email-creator/scripts/css-inliner.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""
+Inline <style> blocks into element style attributes.
+
+Uses premailer to handle CSS specificity correctly. Designed for emails
+built with style blocks (e.g. BeeFree exports) that need inlining for
+Gmail compatibility.
+
+Usage:
+    python3 css-inliner.py input.html
+    python3 css-inliner.py input.html --out output.html
+"""
+
+import argparse
+import sys
+import premailer
+
+
+def inline_css(html: str) -> str:
+    return premailer.transform(
+        html,
+        remove_classes=False,
+        strip_important=True,
+        keep_style_tags=False,
+    )
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Inline CSS for email compatibility")
+    parser.add_argument("input", help="Input HTML file")
+    parser.add_argument("--out", help="Output file (default: stdout)")
+    args = parser.parse_args()
+
+    with open(args.input, "r", encoding="utf-8") as f:
+        html = f.read()
+
+    result = inline_css(html)
+
+    if args.out:
+        with open(args.out, "w", encoding="utf-8") as f:
+            f.write(result)
+    else:
+        sys.stdout.write(result)
+
+
+if __name__ == "__main__":
+    main()

package/plugins/ima-claude/skills/ima-email-creator/scripts/espocrm-prep.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""
+Extract body content from any HTML email and wrap it in a styled div.
+
+Strips document-level tags (<html>, <head>, <body>) and migrates body styles
+to a wrapping div. Works on BeeFree exports, IMA emails, or any HTML.
+
+Usage:
+    python3 espocrm-prep.py input.html
+    python3 espocrm-prep.py input.html --out output.html
+"""
+
+import argparse
+import sys
+from bs4 import BeautifulSoup
+
+
+def extract_body_content(html: str) -> str:
+    soup = BeautifulSoup(html, "html.parser")
+    body = soup.find("body")
+
+    if body is None:
+        return html
+
+    style = body.get("style", "")
+    inner_html = body.decode_contents()
+
+    if style:
+        return f'<div style="{style}">{inner_html}</div>'
+    return inner_html
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Prepare HTML email for EspoCRM")
+    parser.add_argument("input", help="Input HTML file")
+    parser.add_argument("--out", help="Output file (default: stdout)")
+    args = parser.parse_args()
+
+    with open(args.input, "r", encoding="utf-8") as f:
+        html = f.read()
+
+    result = extract_body_content(html)
+
+    if args.out:
+        with open(args.out, "w", encoding="utf-8") as f:
+            f.write(result)
+    else:
+        sys.stdout.write(result)
+
+
+if __name__ == "__main__":
+    main()

package/plugins/ima-claude/skills/ima-email-creator/scripts/requirements.txt

@@ -0,0 +1,2 @@
+beautifulsoup4>=4.12
+premailer>=3.10