Le code court [campaigns] vous permet d'afficher une collection de campagnes dans vos articles ou pages.

Paramètres

• number : Le nombre de campagnes à afficher. Définissez cette valeur sur -1 pour afficher toutes les campagnes. Par défaut, le nombre d'articles que vous affichez sur les pages de blog.
• orderby : L'ordre dans lequel les campagnes sont affichées. Les options incluent post_date, popular et ending. Depuis la version 1.4, vous pouvez également utiliser l'une des options que WP_Query accepte. Par défaut, post_date.
• order : Change la direction dans laquelle les campagnes sont triées. Accepte DESC ou ASC. Par défaut, DESC.
• category : Affiche uniquement les campagnes de certaines catégories, identifiées par leur slug. Passez plusieurs slugs de catégories sous forme de liste séparée par des virgules pour inclure plus d'une catégorie.
• tag : Affiche uniquement les campagnes avec certaines étiquettes, identifiées par leur slug. Passez plusieurs slugs d'étiquettes sous forme de liste séparée par des virgules pour inclure plus d'une étiquette. Introduit dans Charitable Pro.
• creator : Affiche uniquement les campagnes créées par un certain utilisateur. L'ID utilisateur doit être passé.
• exclude : Exclut des campagnes spécifiques par leur ID. Passez plusieurs ID sous forme de liste séparée par des virgules pour en exclure plus d'un.
• include_inactive : Inclut les campagnes expirées en définissant cette valeur sur 1 ou true. Par défaut, false.
• status : Filtre les campagnes par statut. Les options incluent active (uniquement les campagnes actives), ended (uniquement les campagnes terminées) ou all (toutes les campagnes quel que soit leur statut). Ce paramètre a priorité sur include_inactive. Introduit dans Charitable Pro.
• columns : Choisissez le nombre de colonnes dans lesquelles vous souhaitez afficher les campagnes. Prend en charge tout nombre entre 1 et 4. Par défaut, 2.
• button : Choisissez si vous souhaitez afficher un bouton Faire un don (par défaut), un lien lire la suite (button="details"), ou rien du tout (button="0").
• id : Affiche des campagnes spécifiques. Vous pouvez fournir un seul numéro ou plusieurs ID sous forme de liste séparée par des virgules.
• parent_campaigns : Affiche uniquement les campagnes enfants des ID de campagnes parents spécifiés. Passez plusieurs ID sous forme de liste séparée par des virgules. Introduit dans Charitable Pro 1.8.5.
• parent_only : Affiche uniquement les campagnes parents (campagnes de premier niveau sans parent). Définissez sur 1 ou true pour activer. Ce paramètre a priorité sur parent_campaigns. Introduit dans Charitable Pro.
• description_limit : Limite le nombre de mots affichés de la description de la campagne. Accepte tout entier positif. Par défaut, 100. Introduit dans Charitable Pro.
• responsive : Adaptez les campagnes à une mise en page à colonne unique sur les petits écrans. Réglez sur 0 pour désactiver le comportement adaptatif, ou spécifiez un point de rupture personnalisé avec une valeur en px ou em. Le point de rupture par défaut est 768px.
• masonry : Affichez les campagnes dans une mise en page en mosaïque (comme Pinterest). Réglez sur 1 pour activer la mise en page en mosaïque. Par défaut, la valeur est 0.
• pagination : Activez ou désactivez la pagination pour la liste des campagnes. Réglez sur true pour activer la pagination, false pour la désactiver. Par défaut, la valeur est false. Introduit dans Charitable Pro 1.8.6.1.
• pagination_position : Contrôlez où la pagination apparaît par rapport à la liste des campagnes. Les options incluent haut, bas ou les deux. Par défaut, la valeur est bas. Introduit dans Charitable Pro 1.8.6.1.
• pagination_prev_next : Contrôlez si les liens Précédent/Suivant doivent être affichés dans la pagination. Réglez sur true pour afficher ces liens, false pour les masquer. Par défaut, la valeur est true. Introduit dans Charitable Pro 1.8.6.1.
• pagination_first_last : Contrôlez si les liens Première/Dernière page doivent être affichés dans la pagination. Réglez sur true pour afficher ces liens, false pour les masquer. Par défaut, la valeur est true. Introduit dans Charitable Pro 1.8.6.1.
• pagination_mid_size : Contrôlez combien de numéros de page afficher de chaque côté de la page actuelle. Accepte tout entier positif. Par défaut, la valeur est 2. Introduit dans Charitable Pro 1.8.6.1.

Utilisation

Utilisation par défaut :

[campaigns]

Inclure les campagnes expirées :

[campaigns include_inactive=1]

Afficher 30 campagnes :

[campaigns number=30]

Trier les campagnes par le montant d'argent qu'elles ont collecté :

[campaigns orderby=popular]

Trier les campagnes par la date de fin (les plus proches de la fin sont affichées en premier) :

[campaigns orderby=ending]

Afficher uniquement les campagnes de la catégorie « problèmes environnementaux » :

[campaigns category=environmental-issues]

Afficher uniquement les campagnes avec des étiquettes spécifiques :

[campaigns tag=urgent,featured]

Afficher uniquement les campagnes de l'utilisateur avec l'ID 33 :

[campaigns creator=33]

Afficher les campagnes en 3 colonnes :

[campaigns columns=3]

Afficher un lien « lire la suite » pour les campagnes :

[campaigns button="details"]

Afficher uniquement les campagnes avec les ID 33 et 44 :

[campaigns id=33,44]

Afficher uniquement les campagnes enfants de la campagne parente avec l'ID 30 :

[campaigns parent_campaigns=30]

Afficher uniquement les campagnes parentes (campagnes de premier niveau) :

[campaigns parent_only=1]

Filtrer par statut de campagne (afficher uniquement les campagnes actives) :

[campaigns status=active]

Filtrer par statut de campagne (afficher uniquement les campagnes terminées) :

[campaigns status=ended]

Limiter la description de la campagne à 50 mots :

[campaigns description_limit=50]

Désactiver le style adaptatif :

[campaigns responsive=0]

Définir un point de rupture personnalisé de 600px pour le style adaptatif :

[campaigns responsive=600px]

Activer la pagination (4 campagnes par page) :

[campaigns 
    number="4" 
    pagination="true" 
    pagination_position="bottom" 
    pagination_prev_next="true" 
    pagination_first_last="true" 
    pagination_mid_size="2"
]

Paramètres supplémentaires ajoutés par les extensions

Ambassadeurs

Si vous utilisez Charitable Ambassadors version 2.0 ou supérieure, des paramètres supplémentaires sont disponibles pour filtrer les campagnes affichées :

• parent : Afficher uniquement les campagnes enfants d'une campagne parente spécifique. C'est un alias pour parent_campaigns lors de l'utilisation de Charitable Ambassadors. Passez plusieurs ID sous forme de liste séparée par des virgules.
• fundraiser_type : Afficher uniquement les campagnes de collecte de fonds d'un type spécifique. Les options incluent :
  • individual – Collectes de fonds individuelles pour des campagnes existantes.
  • team – Collectes d'équipe pour les campagnes existantes.
  • team-member – Campagnes des membres d'équipe.
  • fundraiser – Toute campagne pour une campagne existante ou l'organisation.
  • personal – Toute campagne pour une cause personnelle.
• fundraiser_type_not: Exclure les campagnes de collecte de fonds d'un type spécifique. Passez plusieurs types sous forme de liste séparée par des virgules. Introduit dans Charitable Ambassadors 2.1.0.
• fundraise_button: Si défini sur false, le bouton Collecter des fonds ne sera pas affiché. Définissez-le sur le texte de votre bouton préféré si vous souhaitez afficher le bouton. La valeur par défaut est false.
• join_team_button: Si défini sur false, le bouton Rejoindre l'équipe ne sera pas affiché. Définissez-le sur le texte de votre bouton préféré si vous souhaitez afficher le bouton. La valeur par défaut est false.

Utilisation

Afficher les campagnes qui sont enfants de la campagne parente avec l'ID 30 :

[campaigns parent=30]

Afficher uniquement les campagnes de collecte de fonds d'équipe :

[campaigns fundraiser_type=team]

Afficher uniquement les campagnes personnelles :

[campaigns fundraiser_type=personal]

Exclure les collectes de fonds individuelles :

[campaigns fundraiser_type_not=individual]

Afficher les boutons « Collecter des fonds » et « Rejoindre l'équipe » dans la grille des campagnes :

[campaigns fundraise_button="Fundraise" join_team_button="Join Team"]

Géoréférencement

Si vous avez installé Campaigns Geolocation, vous pouvez afficher les campagnes sur une carte Google, avec quelques paramètres supplémentaires :

• map: Défini sur 1 ou true pour afficher les campagnes sur une carte. La valeur par défaut est false.
• width: Définissez la largeur souhaitée de votre carte. Ceci doit être passé comme une largeur CSS valide (400px, 100%, etc.). La valeur par défaut est 100%.
• height: Définissez la hauteur souhaitée de votre carte. Ceci doit être passé comme une hauteur CSS valide. La valeur par défaut est 500px.
• zoom: Définissez le niveau de zoom initial auquel vous souhaitez que votre carte s'affiche. La valeur par défaut est auto, le niveau de zoom étant basé sur les épingles ajoutées à la carte.

Utilisation

Afficher les campagnes sur une carte avec une largeur de 900px, une hauteur de 600px et un niveau de zoom défini sur 5 :

[campaigns map=1 width=900px height=600px zoom=5]