Les codes courts

[customer-area-menu /]

Celui-ci est assez trivial, il affiche simplement le menu de navigation où vous le souhaitez. Ce code court n’accepte aucun paramètre.

Disponible depuis WP Customer Area 6.1

[customer-area-protected-content /]

Interroge la base de données et affiche le contenu protégé appartenant ou créé par un utilisateur. Ce code court peut être très utile si vous avez l’extension Protection de contenus tierce et que vous voulez ajouter une page dans l’espace privé où sont listés les contenus d’un type donné assignés à l’utilisateur courant.

Disponible depuis WP Customer Area 6.1

Paramètres

nom valeur par défaut description
type (*) Le type de contenu correspondant aux contenus stockés dans la base de données WordPress. Ce paramètre est obligatoire.
show owned Quels items seront affichés : soit owned, qui récupère tous les items associés à l’utilisateur courant, ou authored, qui récupère tous les items qui ont été créés par l’utilisateur courant.
layout default La disposition à utiliser pour afficher les items (voir ci-dessous pour plus d’information). Actuellement, deux dispositions sont implémentées : default qui affiche les items comme sur le tableau de bord et list qui affiche les items dans une simple liste HTML. Vous pouvez cependant utiliser n’importe quelle nom de disposition à condition que vous implémentiez les fichiers modèle correspondant.
max_items -1 Le nombre maximal d’éléments à récupérer. You can set to -1 if you want to show all items, or any positive number to show at most this many items.
taxonomy empty Le nom de la taxonomie à utiliser pour filtrer les contenus. Par exemple, utilisez cuar_private_file_category si vous voulez filtrer les fichiers privés selon la catégorie à laquelle ils appartiennent.
terms empty Les termes de la taxonomie à utiliser pour le filtrage. Par défaut, vous devez donner des ID de termes. Vous pouvez saisir plusieurs termes en les séparant avec une virgule (ex. 12,15,18). Obligatoire si vous spécifiez le paramètre taxonomy.
terms_field term_id Par défaut, vous spécifiez les termes en utilisant leur ID. Si vous préférez cependant, vous pouvez spécifier les slugs. Alors vous devez mettre ce paramètre à slug.
terms_operator IN Par défaut, le contenu sera filtré comme appartenant à (IN) la liste de termes. Si vous le voulez, vous pouvez à la place lister les contenus qui ne sont pas (NOT IN) dans la liste de termes.

Examples

1. Lister au plus 2 pages privées, avec la disposition liste, assignés à l’utilisateur courant

[customer-area-protected-content type="cuar_private_page" 	 
 max_items="2" 	 	
 show="owned" 	 	
 layout="list" /]

2. Lister toutes les pages privées assignées à l’utilisateur courant et n’étant pas classifiées dans les catégories avec ID 12 ou 25

[customer-area-protected-content type="cuar_private_page"
 taxonomy="cuar_private_page_category"
 terms="12,25"
 terms_operator="NOT IN" /]

Quelques détails de plus à propos des dispositions

Vous pouvez utiliser les dispositions fournies dans WP Customer Area, ou vous pouvez tout aussi bien utiliser n’importe quel nom de disposition que vous souhaitez et implémenter les fichiers de modèle correspondant.

Le code court utilisera quatre fichiers qui vont :

  • Définir comment on itère les items
  • Afficher quelque chose avant les items
  • Afficher quelque chose après les items
  • Définir comment un item est affiché

Ces quatre fichiers modèle seront nommés selon le paramètre layout et/ou le type de contenu. Bien sûr, vous pouvez (devriez) activer les informations de deboggage pour voir précisément quels fichiers sont demandés pour savoir lesquels vous devez implémenter.