Create and Edit Content

This guide explains how to add news articles and institutional pages to the Bemba site.

Create a New Article

Step 1: Access the Form

1. Go to Administration > CMS (/parametres/cms)
2. Select the Articles tab
3. Click the New button

You are redirected to the creation form: /parametres/cms/new?type=article

Step 2: Fill in the Form

The form is organized into several sections:

General Information

Field	Description	Required
Type	Article or Page (pre-filled)	Yes
Title	Main title in French	Yes
Slug	Content URL (automatically generated from title)	Yes
Summary	Short summary displayed in lists	No
Category	Article category	No
Cover image	URL of image illustrating the content	No
Tags	Keywords separated by commas	No
Meta description	SEO description	No
Order	Display order number	No
Pinned	Display at top of list	No

:::tip Automatic Slug The slug is automatically generated from the title. For example, the title "Program launch" becomes program-launch. You can modify it manually if needed. :::

Content (Markdown)

Content is written in Markdown, a simple formatting language:

## Section Title

Text paragraph with **bold** and *italic*.

### Subtitle

- Point 1
- Point 2
- Point 3

> Important quote or note

| Column 1 | Column 2 |
|----------|----------|
| Data A   | Data B   |

:::info Markdown Help Markdown supports: headings (##), lists (-), bold (**text**), italic (*text*), links ([text](url)), images (![alt](url)), tables, and quotes (>). :::

Step 3: Multilingual Translations

The form has language tabs (FR, EN, PT) for each text field:

1. First write the content in French (FR tab)
2. Switch to the EN tab to add the English version
3. Switch to the PT tab for the Portuguese version

Translated fields are:

• Title
• Content
• Summary

:::caution Important The French title is required. Translations are optional but recommended so content displays correctly in all three languages. :::

Step 4: Preview

Click the Preview button to see the Markdown content rendering before saving.

Step 5: Save

Several save options:

Action	Result
Save draft	Saves with "Draft" status
Submit for review	Changes to "Under Review" status
Publish	Immediate publication (visible to all)

---

Create an Institutional Page

The procedure is identical to creating an article:

1. In the CMS, select the Pages tab
2. Click New
3. Fill in the form (the "Page" type is pre-selected)

:::info Difference article vs page

• Article: dated content (news, announcements), displayed chronologically
• Page: permanent content (about, contact, policy), displayed in custom order :::

---

Edit Existing Content

1. In the CMS, find the content to edit in the list
2. Click the Edit icon (pencil)
3. The form opens pre-filled with existing data
4. Make your changes
5. Save

---

Publish Content

From the List

1. Find content with "Draft" or "Under Review" status
2. Click the Publish icon (upward arrow)
3. Content changes to "Published" status and becomes visible

From the Form

1. Open the content in edit mode
2. Click Publish instead of "Save draft"

---

Delete Content

1. Find the content in the CMS list
2. Click the Delete icon (trash)
3. Confirm deletion

:::caution Attention Deletion is permanent. Content cannot be recovered. If you simply want to remove content from display, prefer archiving. :::

---

Manage Categories

Categories allow you to organize articles by theme.

Create a Category

1. In the CMS, go to the Categories tab
2. Click Add a category
3. Fill in:
   • Category name
   • Description (optional)
4. Click Create

Category Examples

Category	Usage
News	General project news
Press Releases	Official communications
Events	Workshops, meetings, training
Reports	Report publications

---

View Published Content

Connected users can access published content via the Communication menu:

News

• Menu: Communication > News
• URL: /actualites
• Display: chronological list with category filters and search
• Click an article to see details

Institutional Pages

• Menu: Communication > Institutional Pages
• URL: /pages
• Display: ordered list with search
• Click a page to see details

Multilingual Display

Content automatically displays in the user's selected language:

• If translation exists in chosen language, it is displayed
• Otherwise, French content (default language) is displayed

---

Best Practices

Writing

• Use short, descriptive titles (under 80 characters)
• Write a summary of 1-2 sentences for each content
• Structure content with section headings (##, ###)
• Add relevant tags to facilitate search

Organization

• Assign a category to each article
• Use pinning to highlight important content
• Archive obsolete content rather than deleting it
• Translate important content into all 3 languages

Images

• Use publicly accessible image URLs
• Prefer reasonably sized images (< 500 KB)
• Add a cover image for important articles