---
title: Usage
description: "## 4.1 Running your first manual synchronisation 1. Check that your API token is configured in **[MP] Digiforma > Settings > API** 2. Go to **[MP] Digiforma > Synchronization** 3. Click the **Synchronize Now** button 4. A real-time progress bar…"
url: "https://maximepotier.fr/en/docs/usage/"
updated: "2026-03-04"
category: "[MP] Digiforma"
---

# Usage

## 4.1 Running your first manual synchronisation

1. Check that your API token is configured in **[MP] Digiforma > Settings > API**
2. Go to **[MP] Digiforma > Synchronization**
3. Click the **Synchronize Now** button
4. A real-time progress bar shows each step: connecting to the API, fetching data, processing, saving to database
5. When complete, a message indicates the number of training courses synchronised

Your training courses are now visible in **[MP] Digiforma > Trainings** and on your site at the configured address (by default `yoursite.com/formations`).

## 4.2 Using Gutenberg blocks

The plugin provides **9 Gutenberg blocks** available in the **[MP] Digiforma** category of the block editor.

| Block | Description | Where to use it |
| --- | --- | --- |
| **Formation Details** | Displays a specific field of a training course (description, objectives, programme, duration, price...) | Individual training page |
| **Formation Sessions** | Displays a list of upcoming sessions with dates and locations. 3 layouts: list, grid, compact | Individual training page |
| **Formation List** | Displays a catalogue of training courses in grid or list format with pagination | Archive page, homepage |
| **Formation Instructors** | Displays the list of instructors associated with a training course | Individual training page |
| **Formation Search** | Displays an AJAX search engine and filters to find a training course | Archive page, dedicated page |
| **Registration Form** | Displays a registration form for a training course (inter, intra or info request) | Individual training page |
| **Calendar** | Displays an interactive calendar (FullCalendar.js) with all sessions | Dedicated page |
| **QR Code** | Displays a QR code linking to the current training course | Individual training page |
| **Upcoming Sessions** | Displays the next upcoming sessions across all training courses | Sidebar, homepage, footer |

**To insert a block:**

1. Edit a page or post in the WordPress editor
2. Click the **+** button (block inserter)
3. Search for **Digiforma** or browse the **[MP] Digiforma** category
4. Click the desired block to insert it
5. Configure options in the right-hand sidebar panel

**Block Patterns (pre-configured templates):**

The plugin includes 3 ready-to-use patterns:

- **Complete Training Layout**: a full template with all training details
- **Sessions List**: upcoming sessions in a grid
- **Training Catalog**: a catalogue of 9 training courses in 3 columns

To use them: in the editor, click **+**, then go to the **Patterns** tab and search for **[MP] Digiforma**.

## 4.3 Using shortcodes

Shortcodes are short codes you can insert into any page, post or text widget. They are compatible with all themes and page builders.

### `[mpd_field]` — Display a training field

Displays a specific piece of data from the current training course.

```
[mpd_field field="duree"]
[mpd_field field="tarif"]
[mpd_field field="objectifs" format="list"]
[mpd_field field="sessions" format="raw"]
```

| Parameter | Possible values | Description |
| --- | --- | --- |
| `field` | `description`, `programme`, `public`, `objectifs`, `modalites`, `duree`, `tarif`, `sessions`, `formateurs`, `lien_inscription` | The field to display |
| `format` | `text` (default), `list`, `raw` | The output format |

### `[mpd_registration_form]` — Registration form

Displays a registration form for the current training course.

```
[mpd_registration_form type="inter"]
[mpd_registration_form type="intra"]
[mpd_registration_form type="info"]
```

| Parameter | Possible values | Description |
| --- | --- | --- |
| `type` | `inter` (default), `intra`, `info` | Registration type: inter-company, intra-company, information request |

### `[mpd_calendar]` — Sessions calendar

Displays an interactive calendar with all sessions across all training courses.

```
[mpd_calendar]
```

### `[mpd_qrcode]` — QR Code

Displays a QR code linking to the current training course URL.

```
[mpd_qrcode]
[mpd_qrcode size="200"]
```

| Parameter | Default | Description |
| --- | --- | --- |
| `size` | `150` | QR code size in pixels |

### `[mpd_formation_search]` — Training search

Displays an AJAX-powered search engine with filters to find training courses.

```
[mpd_formation_search]
```

## 4.4 Viewing and exporting data as CSV

1. Go to **[MP] Digiforma > Export**
2. Choose the data type to export: **Training courses**, **Sessions** or **Registrations**
3. Click **Export**
4. A CSV file is downloaded, which can be opened with Excel, Google Sheets or any spreadsheet application

## 4.5 Customising appearance via the Customizer

The plugin adds a **[MP] Digiforma - Appearance** section to the WordPress Customizer, allowing you to customise the look of your training pages without touching any code.

1. Go to **Appearance > Customize** (or click the **Appearance** link in the plugin settings)
2. Open the **[MP] Digiforma - Appearance** section
3. Adjust the settings:

| Setting | Description | Default |
| --- | --- | --- |
| **Primary colour** | Colour of buttons, links and primary elements | `#2563eb` (blue) |
| **Secondary colour** | Colour of secondary elements and highlights | `#1e40af` (dark blue) |
| **Text colour** | Text colour on training pages | `#1a202c` (very dark grey) |
| **Card background colour** | Background colour of training cards | `#ffffff` (white) |
| **Accent colour** | Colour of badges and accent elements | `#059669` (green) |
| **Border radius** | Corner rounding of cards and elements (0–20 px) | `8px` |
| **Card spacing** | Space between training cards (10–40 px) | `20px` |

Changes are previewed in real time. Click **Publish** to apply them.

---
