multisite-cms-mcp 1.0.6 → 1.0.8

package/dist/tools/get-conversion-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAsgB1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}
+{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAmkB1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}

package/dist/tools/get-conversion-guide.js

@@ -61,10 +61,10 @@ Do NOT change it to \`/blog\`.
 Use the manifest's path configuration to maintain original URLs.`,
     structure: `# Package Structure
 
-Create a ZIP file with this exact structure:
+Create a package with this structure (can be at repo root OR in a subfolder like cms_package/):
 
 \`\`\`
-website-package.zip
+website-package/           # Can be at root or in a subfolder
 ├── manifest.json          # Required: Defines pages and CMS templates
 ├── public/                # Static assets (CSS, JS, images, fonts)
 │   ├── css/
@@ -84,6 +84,26 @@ website-package.zip
     └── downloads.html
 \`\`\`
 
+**SUPPORTED REPO STRUCTURES:**
+\`\`\`
+Option 1: CMS files at root
+repo/
+├── manifest.json
+├── pages/
+├── public/
+└── templates/
+
+Option 2: CMS files in subfolder (e.g. for Next.js projects)
+repo/
+├── app/                   # Next.js app (ignored)
+├── cms_package/           # CMS files here
+│   ├── manifest.json
+│   ├── pages/
+│   ├── public/
+│   └── templates/
+└── package.json
+\`\`\`
+
 ## Folder Rules
 
 ### public/
@@ -169,7 +189,7 @@ For dynamic collections beyond the built-ins:
 2. **Detail Templates** - Single item pages (blog_post.html)
 3. **Static Pages** - Fixed content with data-edit-key
 
-## Index Template Pattern
+## Index Template Pattern (Blog List)
 
 \`\`\`html
 <main class="blog-page">
@@ -192,7 +212,15 @@ For dynamic collections beyond the built-ins:
 </main>
 \`\`\`
 
-## Detail Template Pattern
+**CRITICAL FIELD NAMES for blogs:**
+- \`{{name}}\` = Post title (NOT {{title}})
+- \`{{mainImage}}\` = Hero image (NOT {{coverImageUrl}})
+- \`{{thumbnailImage}}\` = Preview image
+- \`{{postSummary}}\` = Excerpt (NOT {{excerpt}})
+- \`{{{postBody}}}\` = Content (NOT {{bodyHtml}}, uses TRIPLE braces)
+- \`{{url}}\` = Generated link to detail page
+
+## Detail Template Pattern (Blog Post)
 
 \`\`\`html
 <article class="blog-post">
@@ -208,12 +236,44 @@ For dynamic collections beyond the built-ins:
     </div>
   {{/if}}
   
+  {{#if publishedAt}}
+    <time>{{publishedAt}}</time>
+  {{/if}}
+  
   <div class="content">
     {{{postBody}}}
   </div>
 </article>
 \`\`\`
 
+## Team Template Pattern
+
+\`\`\`html
+<div class="team-grid">
+  {{#each team sort="order" order="asc"}}
+  <div class="team-member">
+    {{#if photo}}
+      <img src="{{photo}}" alt="{{name}}">
+    {{/if}}
+    <h3>{{name}}</h3>
+    {{#if role}}
+      <p class="role">{{role}}</p>
+    {{/if}}
+    {{#if bio}}
+      <div class="bio">{{{bio}}}</div>
+    {{/if}}
+  </div>
+  {{/each}}
+</div>
+\`\`\`
+
+**CRITICAL FIELD NAMES for team:**
+- \`{{name}}\` = Team member name
+- \`{{role}}\` = Job title
+- \`{{photo}}\` = Headshot (NOT {{picture}})
+- \`{{{bio}}}\` = Biography (TRIPLE braces for HTML)
+- \`{{order}}\` = Display order
+
 ## Static Page Pattern
 
 \`\`\`html
@@ -363,33 +423,34 @@ Forms are automatically captured by the CMS.
 
 ## Form Handler Script
 
-Add to your JavaScript:
+Add to your JavaScript (typically /public/js/main.js):
 
 \`\`\`javascript
 document.querySelectorAll('form[data-form-name]').forEach(form => {
   form.addEventListener('submit', async (e) => {
     e.preventDefault();
     
+    const formName = form.dataset.formName || 'general';
     const formData = new FormData(form);
     const data = Object.fromEntries(formData);
     
-    const response = await fetch('/api/forms/submit', {
+    // IMPORTANT: Endpoint is /_forms/{formName}
+    const response = await fetch('/_forms/' + formName, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        formName: form.dataset.formName,
-        data: data
-      })
+      body: JSON.stringify(data)
     });
     
     if (response.ok) {
       form.reset();
-      alert('Thank you!');
+      alert(form.dataset.successMessage || 'Thank you!');
     }
   });
 });
 \`\`\`
 
+**CRITICAL:** The form endpoint is \`/_forms/{formName}\` - NOT \`/api/forms/submit\`
+
 ## Naming Conventions
 
 - Contact form → \`contact\`

package/dist/tools/get-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CA+KjD"}
+{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAmOjD"}

package/dist/tools/get-schema.js

@@ -178,5 +178,57 @@ For HTML content that should NOT be escaped:
 3. **Always wrap optional fields in {{#if}}** - Check before rendering
 4. **Use {{url}} for links** - Generates correct path based on manifest
 5. **Match field names exactly** - \`{{name}}\` not \`{{title}}\`
+
+---
+
+## Form Handling
+
+Forms are automatically captured and stored in the CMS.
+
+### Form Setup
+1. Add \`data-form-name="xxx"\` attribute to the form
+2. Include the form handler script in your JavaScript
+
+\`\`\`html
+<form data-form-name="contact">
+  <input type="text" name="firstName" required>
+  <input type="email" name="email" required>
+  <textarea name="message"></textarea>
+  <button type="submit">Send</button>
+</form>
+\`\`\`
+
+### Form Handler Script (add to /public/js/main.js)
+\`\`\`javascript
+document.querySelectorAll('form[data-form-name]').forEach(form => {
+  form.addEventListener('submit', async (e) => {
+    e.preventDefault();
+    const formName = form.dataset.formName || 'general';
+    const formData = new FormData(form);
+    const data = Object.fromEntries(formData);
+    
+    const response = await fetch('/_forms/' + formName, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(data)
+    });
+    
+    if (response.ok) {
+      form.reset();
+      alert(form.dataset.successMessage || 'Thank you!');
+    }
+  });
+});
+\`\`\`
+
+**CRITICAL:** Endpoint is \`/_forms/{formName}\` - NOT \`/api/forms/submit\`
+
+### Common Form Names
+- \`contact\` - Contact/inquiry forms
+- \`newsletter\` - Email signups
+- \`quote-request\` - Quote/consultation requests
+- \`appointment\` - Scheduling forms
+
+Tenant context is handled automatically by the system.
 `;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "MCP server for AI-assisted website conversion to CMS format. Provides validation, examples, and schema tools.",
   "main": "dist/index.js",
   "bin": {