CMS User Guide

Purpose

• Browse and filter heritage blog/article records.
• Edit title, summary, body, and metadata.
• Save drafts safely.
• Publish articles when they meet quality thresholds.

Current CMS tabs: Gurbani, Gurudwara, and Heritage articles (active editing workflow).

Access and Sign-in

1. Open cms/blogentry.php.
2. Sign in with your site account if prompted.
3. If authorized as editor/admin, you enter CMS.
4. If unauthorized, you are redirected to Dashboard.

Heritage Articles workflow

1) Find an article

• Use filters for Categories, Era, Guru period, and Search.
• Use Status for All, Published, or Drafts.
• Click Edit for the selected row.

2) Edit content

• Update Title and Summary.
• Edit Body (HTML allowed).
• Adjust Type, Era, and Guru period when needed.
• Use Metadata (JSON) only when structure is understood.
• Add optional Editor notes.

3) Word count and publishing rule

• Word count is shown live.
• Publish threshold is 1000 to 10000 words.
• Draft save is allowed outside threshold; publish is blocked by server validation.

4) Save draft or publish

• Save draft stores progress without publishing.
• Save & publish attempts immediate publish.
• View live opens public article page.

Field guidance

• Title: concise and clear, up to 255 chars.
• Summary: short overview for list/SEO contexts.
• Body: complete long-form content.
• Metadata: valid JSON object.
• Published: set Draft while under review.

Troubleshooting

"Forbidden" or redirected out of CMS

• Your account likely lacks editor/admin role.
• Ask CMS Admin to verify role and active status.

"Invalid metadata JSON"

• Fix quotes, commas, and braces.
• If unsure, clear metadata and save draft first.

Publish fails on word count

• Adjust body content to fit 1000-10000 words.
• Save as draft until threshold is met.

Documentation maintenance

Whenever CMS features evolve, update both CMSuserguide.md and cms/CMSuserguide.php in the same change.