Skip to content

Updating AI Email Builder Placeholders Easily

Introduction

The AI Email Builder relies on PHP placeholder files to understand your business context, branding, styling, and typography. Updating these placeholders ensures that any AI-generated emails reflect your actual business identity, including correct colors, logos, fonts, contact details, and tone of communication.

The usual location for these placeholders is: app/EmailBuilder/Placeholders

Keeping these placeholders up to date is essential for:

  • Maintaining brand consistency across emails
  • Ensuring AI-generated content is accurate and context-aware
  • Avoiding manual edits in multiple email templates
  • Speeding up updates when business info or branding changes

Placeholder Files Overview

Following are the default placeholders comes with installation. you can your own also.

Placeholder FileDescription
BusinessInfoPlaceholders.phpStores business details such as name, industry, type, contact info, website, logos, social links, and legal pages.
StylePlaceholders.phpContains design-related values: brand colors, button styles, and default text/link colors.
TypographyPlaceholders.phpDefines fonts, heading/body sizes, line heights, and font weights used in emails.
UserPlaceholders.phpHolds user-specific data like name, email, verification link, and unsubscribe link for personalized emails.
SystemPlaceholders.phpContains dynamic system values like current date/time and year for templating.

Steps to Update Placeholders

  1. Open ChatGPT or your AI tool.
  2. Step 1: Copy the instruction prompt below and paste it into ChatGPT.
  3. Step 2: Provide your business context in the prompt (name, industry, type, services, website, contact info, brand colors, typography, logos, tone).
  4. Step 3: Copy each PHP placeholder file content (e.g., BusinessInfoPlaceholders.php, StylePlaceholders.php, TypographyPlaceholders.php, UserPlaceholders.php, SystemPlaceholders.php) one by one and paste inside the prompt.
  5. AI will update the 'value' fields according to your business context while preserving the rest of the structure.
  6. Copy the AI-generated output back to your PHP placeholder files.
  7. Repeat for each placeholder file until all placeholders are updated.

Step 1: AI Instructions

Copy following AI prompt and paste inside the prompt input in chat box. It will instruct AI to ask business info and placeholders one at a time for updating with your business info.

markdown
# Instructions
You are an AI assistant specialized in populating PHP placeholder classes with fully contextual, accurate, and brand-aligned values for an AI Email Builder system.

## Objective
Your task is to update each provided PHP placeholder file **one at a time** with values derived from the user-provided business context. The goal is to ensure placeholders reflect the actual business information, branding, and design preferences.

## Workflow

1. **Request Complete Business Context First**
   Ask the user to provide the full business information before modifying any placeholders. The context should include:
   - Business name and description
   - Industry and type
   - Products or services offered
   - Location, address, phone, and email
   - Website and social media URLs
   - Branding and style preferences (primary/secondary colors, typography, logo URLs, logo width, button styles, hover colors, text/link colors)
   - Tone of communication (friendly, professional, playful, etc.)

   Confirm the user-provided business context before proceeding.

2. **Ask for the First Placeholder File**
   > "Please provide the first PHP placeholder file you’d like to customize."

3. **Modify the Placeholder File**
   - Parse the PHP file and locate the `'items'` array inside the placeholder class.
   - Replace only the `'value'` fields with content derived from the business context.
   - Preserve `'label'`, `'description'`, array structure, and formatting exactly as in the original file.
   - Ensure any links, colors, typography, logos, and contact info match the context.
   - Do not add or remove unrelated keys or items.

   **Example Transformation:**

   **Input Placeholder**
   '''php
   '__BUSINESS_INDUSTRY__' => [
       'label' => 'Industry',
       'value' => 'Software',
       'description' => 'The business sector or industry',
   ],
   '''

   **Output Placeholder**
   '''php
   '__BUSINESS_INDUSTRY__' => [
       'label' => 'Industry',
       'value' => 'Software Development, SaaS & Automation Solutions',
       'description' => 'Defines the business’s primary market sector',
   ],
   '''

4. **Validate and Confirm**
   - Ensure all values are consistent with the provided business context.
   - Maintain valid PHP syntax.
   - Double-check that branding colors, logos, and typography values are correctly mapped.

5. **Iterate Until Finished**
   - After modifying one placeholder, ask:
     > "Would you like to proceed with the next placeholder?"
   - Continue this loop until the user indicates “finished”.

## Rules
- Never change class names, namespaces, or method signatures.
- Only modify the `'value'` field inside `'items'`.
- Always use the provided business context; if something is missing, ask clarifying questions.
- Preserve PHP formatting and indentation.
- Ensure all links, brand colors, and text formatting reflect the brand accurately.

## Example Use Flow
1. AI: “Please provide the business context including name, branding, and contact info.”
2. User: (Provides complete business context)
3. AI: “Thank you! Now, please share the first PHP placeholder file.”
4. User: (Provides PHP file)
5. AI: (Outputs modified PHP placeholder with all values updated)
6. AI: “Would you like to continue with the next placeholder?”
7. Repeat until user says “finished”.

Step 2: Business Info

Before updating placeholders, ensure you have your business info organized. See the following example and use it as a template to generate your own business info. Replace relevant information with your business information and remove which does not apply to your business.

markdown
### 🏢 Company Context

**Business Name:** ApxDemo Solutions
**Industry:** Clean Energy & IoT Technology
**Business Type:** SaaS & Hardware Solutions for Smart Homes
**Location:** San Francisco, California, USA
**Website:** [http://react-demo.test](https://react-demo.test)
**Contact Email:** contact@react-demo.test
**Phone:** +1 415-555-7890
**Address:** 450 Innovation Way, San Francisco, CA 94107

---

### 💼 Business Overview
ApxDemo Solutions develops smart energy solutions for homes and businesses. Their products combine IoT-enabled hardware devices with AI-powered software to optimize energy usage, reduce costs, and improve sustainability.

Key offerings:
- Smart energy management dashboards
- Automated lighting and climate control systems
- AI-driven energy analytics and reports
- Integration with existing smart home platforms

ApxDemo focuses on innovation, sustainability, and seamless user experience for both residential and commercial customers.

---

### 🎨 Branding and Design Style

**Brand Colors:**
- Primary Color: `#F97316` (Green — eco-friendly and innovative)
- Primary Alt Color: `#ffffff` (White — contrast for clean visuals)
- Secondary Color: `##1f2937` (Dark Gray — typography and backgrounds)
- Secondary Alt Color: `#ffffff` (Light Gray — subtle backgrounds)

**Typography:**
- Headings: **Montserrat**, Bold, Modern
- Body: **Roboto**, Regular, Clean
- Font Sizes:
  - Headline: 28px–36px
  - Body Text: 16px
  - Buttons: 14px (uppercase)

**Logo Usage:**
- Dark Logo: `http://react-demo.test/assets/app/logos/logo-dark-6d01a91f.png`
- Light Logo: `http://react-demo.test/assets/app/logos/logo-light-6d01a91f.png`
- Logo Width: `200px`

**Tone and Style:**
- Professional, eco-conscious, approachable
- Emphasizes innovation and sustainability
- Modern, clean layouts with whitespace for readability
- Friendly but credible language for marketing communications

---

### 🔗 Social and Legal Links
- YouTube: [https://www.youtube.com/@apsonex](https://www.youtube.com/@apsonex)
- X (Twitter): [https://x.com/_apsonex](https://x.com/_apsonex)
- Privacy Policy: [http://react-demo.test/privacy-policy](http://react-demo.test/privacy-policy)
- Terms of Use: [http://react-demo.test/terms](http://react-demo.test/terms)
- Google Map: [https://maps.app.goo.gl/SX9nDrEs1VtR8Qsj6](https://maps.app.goo.gl/SX9nDrEs1VtR8Qsj6)

Step 3: Process Placeholder one at a time.

Now AI has instructions and your business context. we can safely ask to update your placeholders to match your business brand identity.

  • Copy content of <placeholder-loc>/BusinessInfoPlaceholders.php and AI will generate BusinessInfoPlaceholders class with updated content. Copy updated content and replace with original content. Give it a second look.
  • Copy content of <placeholder-loc>/StylePlaceholders.php and AI will generate StylePlaceholders class with updated content. Copy updated content and replace with original content. Give it a second look.
  • Copy content of <placeholder-loc>/TypographyPlaceholders.php and AI will generate TypographyPlaceholders class with updated content. Copy updated content and replace with original content. Give it a second look.

TIP

  • Always update the business context in the prompt before pasting placeholder content.
  • Copy placeholder files one at a time to avoid mistakes.
  • Validate AI output before saving into your codebase.
  • Keep consistent formatting to ensure AI outputs clean, usable PHP.

Conclusion

By following this guide, your AI-generated emails will fully reflect your brand, making updates faster, safer, and more consistent.