Accueil

Cette documentation se concentre sur la partie administrateur du site située à l'adresse https://stats.saferducentre.com/wp-admin. En particulier, ce document ne détaille que les parties relatives aux plugin et thème de la Safer, le reste est documenté sur les sites de WordPress :

• https://fr.wordpress.org/support
• https://fr.wordpress.org/support/category/administration-base

Par la suite :

• {{nom}} : signifie que le nom est variable et est destiné à être changé par l'administrateur.

Dans l'interface d'administration, on trouve un onglet Safer dans la barre latérale.

Au survol, un menu s'affiche, proposant plusieurs pages :

• Paramètres : Contient une section introduction et les paramètres généraux :

  

  1. Lien vers cette documentation

  2. Lien vers le dossier de personnalisation :
     Ce dossier contient tous les fichiers de menus administrateurs et de fonctions utilisables par le plugin (cf Dossier de personnalisation)
     Au clic, ce champ de texte affiche la liste des dossiers disponibles pour le chemin actuel

     

  3. Bouton de validation (ce bouton sera présent sur toutes les pages de paramétrage).

• Paramètres de la base de données (BDD) : Ce page est généré à partir du dossier de personnalisation. Elle contient les paramètres relatifs à la base de données :

  

  1. Type de base de données utilisé par le la librairie PDO de PHP.
     La liste des connecteurs est disponible ici https://www.php.net/manual/fr/pdo.drivers.php.
     Dans le cas présent, le type de connecteur est pgsql (PDO_PGSQL) pour une base de données de type PostgreSQL
  2. L'hôte de la base de données est l'adresse d'accès à la BDD, par exemple : 10.41.1.204 ou ma_bdd.mon_site.fr.
  3. Le port de la base de donnée est le port d'accès au serveur de la BDD. Par défaut, le port est 5432 pour PostgreSQL.
  4. Le nom de la base de données est le nom de la BDD à laquelle se connecter. Par exemple : : BRC.
  5. Le nom d'utilisateur est le nom de l'utilisateur de la BDD. Par exemple : postgres (le compte administrateur de PostgreSQL).
  6. Le mot de passe est le mot de passe de l'utilisateur de la BDD. Par exemple : password (le mot de passe de l'utilisateur postgres, sérieusement, ne mettez pas password comme mot de passe).
  7. La liste des S2PR est une liste de conseiller(ère)s fonciers donnée par personne (pas par fonction, le ou les identifiants associés sont les identifiants de la personne). Lors du clic sur le champ, un menu déroulant s'affiche pour choisir un conseiller parmi la liste des conseillers de la base de données.

Le dossier de personnalisation contient deux sous-dossiers :

• admin: Contient les fichiers de menus administrateurs
• functions: Contient les fonctions utilisables par le plugin

Pour modifier ou créer une page, il faut se rendre sur l'interface de configurations des pages dans l'espace administrateur :

On peut alors :

1. Ajouter une page
2. Modifier une page existent
   Ces deux actions renvoient vers l'éditeur Gutenberg de WordPress.

Le plugin met à disposition un certain nombre de blocs répartis en deux catégories :

• Safer : blocs divers :
  • chart : Bloc enveloppant la librairie EChart pour la génération de graphiques.
  • data : Bloc permettant la récupération de données et le partage aux blocs enfants.
  • function : Bloc permettant d'exécuter une fonction de type block.
  • table : Bloc enveloppant la librairie Datatables pour la gestion de tableaux.
• Tabler : blocs s'inspirant de la bibliothèque Tabler :
  • card : Bloc s'inspirant des cadres.
  • tabs : Bloc s'inspirant de la variante onglet des cadres .
  • tab : Bloc contenu dans le bloc tabs.

La configuration de chaque bloc se fait dans la barre latérale de droite accessible grâce au bouton :

Chaque bloc dispose de champs avancés dont classname permet d'ajouter des class HTML à un bloc. On peut ainsi utiliser les classes mises à disposition par toutes les bibliothèques CSS disponibles (disponibilités : front).

Références :

• WordPress Block Editor – Documentation
• Page/Post Settings sidebar – Documentation – WordPress.org

Disponibilités :

• front : pages côté client (visiteur)
• admin : pages administrateurs (tableau de bord et éditeur Gutenberg)
• editor : seulement l'éditeur Gutenberg
• block : seulement les blocs de l'éditeur Gutenberg
• all : front, admin, editor et block