UID for WordPress

Ajout d'identifiants pérennes et uniques à des publications (post) wordpress selon un type du context schema.org prédéterminé grâce à leur CPT.

Dépendances

• ACF

Schemas

Les schémas sont le travail de Capacoa. J'ai adapté et généré les outils grâce au travail sémantique de Capacoa. Le répertoire contenant les schémas de travail et générés par ce plugin a été ajouté en parallèle. Mais il y a présent dans l'historique de ce répertoire.

Redirection 303

Il faut ajouter des configurations de rewrite pour le serveur afin d'assurer la redirection 303.

Apache

# BEGIN Mamarmite UID remplacer : [DOMAIN] par le domain du site web et [DOMAIN_UID] par le domaine de votre identifiant pérenne.
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^r/([^/.]+)/?$ https://[DOMAIN]/uid/ldjson?uid=http://[DOMAIN_UID]/r/$1 [R=303,NE,L]
</IfModule>
# END Mamarmite UID

La vérification pour la redirection 303 se fait seulement sur un /r/ sur la base du domain sans la vérification du port de connexion : 80 ou 443. Donc les deux fonctionnent.

Terminaisons du plugiciel basées sur le DOMAIN de l'installation.

Terminaison	Description	Paramètre d'url	Nécessaire?	Public cible
/uid	Base du plugiciel, un index actif seulement pour les humains.	-	-	Humain
/list	Toutes les entités en mode lecture pour les humains (avec des liens vers la page de prévisualisation et version json	-	-	Humain
/list.json	Toutes les entités en mode json	-	-	Machine
/preview	Prévisualisation d'un schemas	uid	Oui	Humain
/ldjson	Prévisualisation d'un schemas en format json	uid	Oui	Machine

/list

Principalement pour prévisualiser les entités sur le site par un humain.

Contient :

• Une liste de toutes les entités
• Un raccourci vers la prévisualisation.
• Un raccourci vers l'entité en mode JSON
• Chaque entité contient une balise <script type="application/ld+json" id="[UID]"> (the `[UID] c'est l'entité)
• Si on accède à la page avec un #[UID], on peut cibler le code <script>.

/list.json

Renvoie toutes les entités dans un format JSON avec le format :

{
  "@context": "http://schema.org",
  "@graph": [
    {
      "@type": "Place",
      "@id": "http://topo.art/r/t8575",
      "name": "Etc."
    },
    {
      "@type": "Organization",
      "@id": "http://topo.art/r/t8486",
      "name": "TOPO",
      "description": "etc."
    }
  ]
}

Il n'y a pas de :

• Vérification si les schemas sont bien remplis

Contributeurs

• Marc-André Martin - Mamarmite (développement du plugiciel pour Wordpress.)
• CAPACOA (schémas et structure des données)

Défis du mandat

• Ajouter les UID à des données déjà existantes dans un système.
• Ajouter des ENDPOINT pour le json+ld pratique pour l'utilisateur, les robots et le Robot moissonneur d'Artsdata.
• Encapsuler le plugiciel en mode prototype dans une version intelligible et assez versatile pour devenir un plugiciel complet.

À faire

• :party:

Améliorations

• Automatisation de l'installation avec un flush des rewrites des permalink,
• Automatisation de l'installation vérification qu'ACF est installé et actif.
• Sauvegarder les UID complet dans un meta directement dans la BD.
• Internationalisation des textes, présentement en français seulement.
• Ajustement suite aux premiers moissonnages.

Idées / Backlog

• Ajouter un pourcentage de complétion des schémas par entité dans la table wordpress directement (et dans la vue /list)
• Sélection des groupes de propriétés (ACF) compatibles via une section paramètres dans le plugiciel.