View Categories

Usage

4 min read

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.