Pour éviter les confusions par la suite, et parce qu'il y a des ambigüités avec la terminologie Metadata, les termes utilisé dans MyMeta sont :
- Identifiant de mymeta : correspond à la colonne "ID" dans l'administration, c'est aussi la valeur renseignée dans la colonne meta_type en base de données
- Type de mymeta : type de données entrées dans l'administration (chaîne, liste de valeurs, checkbox, ...)
- Valeur de mymeta : valeur spécifiée dans la colonne mymeta correspondante lors de l'édition d'un billet, c'est aussi la valeur renseignée dans la colonne meta_id en base de données
Note: en écrivant cette documentation, je me rends compte qu'il reste pas mal d'incohérences, et du code à simplifier. La documentation sera mise à jour en conséquence lors de la 0.4 finale. La présentation de ce billet ne me plaît pas non plus, je ferai plus clair dès que j'ai le temps ;)
Blocs
<tpl:MyMetaData>...</tpl:MyMetaData>
Contextes d'utilisation
- Dans un fichier de template de type mymetas.html
Paramètres
- les mêmes que pour tpl:Tags (anciennement tpl:MetaData)
Description
Récupère l'ensemble des valeurs de mymeta pour le mymeta en cours
<tpl:MyMetaIf>...</tpl:MyMetaIf>
Contextes d'utilisation
- Au sein de blocs où le contexte "posts" est défini (tpl:Entries par exemple)
- Dans le template post.html
Paramètres
- type (obligatoire): ID du mymeta à tester
- defined="true" : affiche le contenu du bloc si le mymeta est défini
- value : affiche le contenu du bloc si le mymeta a bien la valeur renseignée
Description
Teste la valeur ou l'existence d'une valeur de mymeta pour le billet en cours
Valeurs
{{tpl:MetaType}}
Contextes d'utilisation
- Dans une boucle tpl:MyMetaData ou similaire (tpl:Tags, ou tpl:EntryTags par exemple)
- Dans un fichier de template de type mymeta.html
Paramètres
- aucun
Description
Affiche le type de métadonnée (qui est l'ID du mymeta, et correspond au meta_type en base).
{{tpl:MyMetaTypePrompt}}
Contextes d'utilisation
- Si le paramètre id est défini, n'importe où
- Sinon :
- dans une boucle tpl:MyMetaData
- dans les templates mymetas.html et mymeta.html
Paramètres
- id (facultatif) : identifiant du mymeta
- type : identique à type, déprécié
Description
Affiche l'invite d'un mymeta (s'il est activé):
- Si id est spécifié, affiche l'invite du mymeta correspondant
- Sinon, affiche l'invite du mymeta dans le contexte de la page ou de la boucle tpl:MyMetaData
{{tpl:MyMetaValue}}
Contextes d'utilisation
- dans une boucle tpl:MyMetaData
- dans les templates mymetas.html et mymeta.html
Paramètres
- id (facultatif) : identifiant du mymeta
- type : identique à type, déprécié
Description
Affiche la valeur d'un mymeta (s'il est activé):
- Si id est spécifié, affiche la valeur du mymeta correspondant
- Sinon, affiche la valeut du mymeta dans le contexte de la page ou de la boucle tpl:MyMetaData
Note: cette balise a un comportement différent dans MyMeta 0.3. Dans un contexte de billet, en 0.4, il faut utiliser tpl:EntryMyMetaValue
{{tpl:MyMetaURL}}
Contextes d'utilisation
- dans une boucle tpl:MyMetaData
- dans les templates mymetas.html et mymeta.html
Paramètres
- id (facultatif) : identifiant du mymeta
- type : identique à type, déprécié
Description
Affiche l'URL d'un mymeta (s'il est activé):
- Si id est spécifié, affiche l'URL du mymeta correspondant
- Sinon, affiche la valeut du mymeta dans le contexte de la page ou de la boucle tpl:MyMetaData
{{tpl:EntryMyMetaValue}}
Contextes d'utilisation
- Au sein de blocs où le contexte "posts" est défini (tpl:Entries par exemple)
- Dans le template post.html
Paramètres
- id (obligatoire): identifiant du mymeta
- type : identique à type, déprécié
Description
Affiche la valeur d'un mymeta (s'il est activé) correspondant à l'ID donné pour le billet en cours (dans la boucle, ou le billet courant si dans le template post.html par exemple)

4 réactions
1 De mirovinben - 09/06/2010, 17:08
Je suis en effet victime d'une incohérence dans la doc aggravée par des neurones un peu fatigués. J'en parle dans le commentaire #6 du billet précédent.
2 De Franck - 09/06/2010, 18:26
Méritoire effort de documenter tout ça mais j'avoue que la lecture du tout début me laisse pour le moins perplexe ! Essentiellement à propos des termes utilisés.
Je reprends le texte :
«Identifiant de mymeta : correspond à la colonne "ID" dans l'administration, c'est aussi la valeur renseignée dans la colonne meta_type en base de données » : dans la même phrase tu parles d'identifiant, d'ID, de valeur et de type.
« Valeur de mymeta : valeur spécifiée dans la colonne mymeta correspondante lors de l'édition d'un billet, c'est aussi la valeur renseignée dans la colonne meta_id en base de données » : là aussi tu parles de valeur puis d'ID.
Résumé je comprends ceci (à peu près) :
* mymeta ID = value(meta_type)
* mymeta value = value(meta_id)
De quoi, à mon humble avis, laisser dans un abîme de perplexité un grand nombre de lecteurs.
Y'a pas moyen d'utiliser des termes et des noms de champs cohérents ?
3 De Dsls - 09/06/2010, 18:56
franck: je suis peut-être allé trop profond dans les détails techniques. Mais les définitions ont bien un sens pour le plugin MyMeta. Utiliser les mêmes termes que metadata induirait plus en erreur, je pense.
4 De Pierre - 09/08/2010, 23:03
Pour la structure conditionnelle : <tpl:MyMetaIf>...</tpl:MyMetaIf>
Comment on fait si on veut exécuter le code si notre meta de type boolean est coché, ou exécuter un autre code si elle n'est pas coché ?
Merci d'avance pour l'aide,
Pierre