Intégration avec le module WordPress

Si votre site Web utilise le CMS Open Source WordPress, nous mettons à votre disposition un plugin qui vous permettra de disposer d’une intégration forte sans devoir implémenter notre API ce qui vous permettra de gagner un temps précieux. Vous bénéficierez également ainsi de la possibilité d’importer les fiches des événements directement dans WordPress ce qui permettra en outre d’utiliser les fonctions de recherche fournies par le CMS et d’éviter de réimplémenter un importeur depuis votre base de données de programmation ou de resaisir vos fiches d’événements.

Installation

Vous pouvez installer notre plugin¹ directement depuis le gestionnaire de plugins de WordPress en cherchant « Ticketack » ; une fois installé, vous devez encore l’activer depuis le gestionnaire des plugins.

Rendez-vous ensuite dans la gestion des permaliens et cliquez simplement sur « Enregistrer » afin d’enregistrer les nouveaux permaliens fournis par le plugin.

Mises à jour

Avant de réaliser une mise à jour du plugin ou du thème, vérifiez que vous avez bien fait une sauvegarde de votre installation complète de WordPress en ayant lu le changelog fourni afin que toute régression, changement incompatible ou installation de fonctionnalités non voulues soit évité.

Prenez particulièrement garde aux mises à jour de thèmes qui peuvent effacer vos personnalisations de mise en page.

Configuration

Le plugin Ticketack doit être configuré pour communiquer avec votre billetterie.

Pour cela, rendez-vous dans la partie Réglages > Ticketack (Onglet API) de l’espace d’administration de votre WordPress et remplissez les champs suivants avec les informations fournies par Net Oxygen :

• URL de l’engine
• URL du eshop
• Clé d’API

Activer les modes de paiement

Le plugin Ticketack vous propose deux modes de reservation dans réglages -> ticketack -> checkout:

1. Autoriser les réservations (reservation sans paiement en ligne).
2. Autoriser les achats (achat avec paiement en ligne).

Création des pages type

Afin d’afficher les contenus du shop en ligne directement sur votre site WordPress, il est nécessaire de créer des pages type (depuis la fonctionnalité de base « Pages » de WordPress) qui viendront recueillir un shortcode spécifique.

En fonction de votre cas d’utilisation, nous vous invitons à créer les pages suivantes :

• Programme (utiliser le shortcode [tkt_program][/tkt_program])
• Panier (utiliser le shortcode [tkt_cart][/tkt_cart])
• Vente d’abonnements (utiliser le shortcode [tkt_buy_pass][/tkt_buy_pass])
• Vente d’articles (utiliser le shortcode [tkt_shop][/tkt_shop])
• Validation d’achat d’article (utiliser le shortcode [tkt_checkout][/tkt_checkout])
• Connexion avec un compte et/ou un ticket (utiliser le shortcode [tkt_user_login][/tkt_user_login] et/ou [tkt_ticket_connect][/tkt_ticket_connect])

Renseigner les pages générales

Une fois les pages types créées, vous pouvez les indiquer au plugin depuis la partie Réglages > Ticketack > Pages.

Import des événements depuis Ticketack

Pour avoir du contenu à afficher il faut d’abord « Importer depuis Ticketack » les Events :

 

Import des articles depuis Ticketack

Pour avoir des articles à afficher dans la partie vente d’articles, il faut d’abord « Importer depuis Ticketack » les Articles :

Shortcodes disponibles

Le plugin vous permet d’utiliser les shortcodes suivant dans vos pages :

Affichage du panier

[tkt_cart][/tkt_cart]

Affichage de l’icône panier

[tkt_cart_icon][/tkt_cart_icon]

Affichage d’un événement

[tkt_event][/tkt_event]

Affichage de la VOD Pantaflix

[tkt_pantaflix_player id=’12345678-1234-1234-1234-123456789012′ pantaflix_id_prefix=’pantaflix_id_prod‘]
Attributes :
id=’screening_id‘
pantaflix_id_prefix=’pantaflix_id_prod‘ (par défaut)

Affichage du formulaire de mise au panier de réservations

[tkt_booking_form layout=“form“ theme=“dark“ ids=“12345678-1234-1234-1234-123456789012″][/tkt_booking_form]

Attributes :

Attributes	Possibles values	Value by default	Description
layout	form|screenings_list	form	Mode d’affichage
theme	dark|light	light	Thème
ids	ID_place1,…2,…3,…		Liste des ids de séances

Affichage d’une partie du programme

[tkt_program layout=“events“ order=“chrono“ xsection_ids=“18_noday“][/tkt_program]

Description des attributs :

Attribut	Valeurs possibles	Valeur par défaut	Description
layout	screenings | events	screenings	Offre la possibilité d’afficher les séances ou les films2
template	list | grid | gallery	list	Définit le type d’affichage (cf : choix du template)
item_width	12/nb_colonne_par_item	12	Définit le nombre de colonnes par item3
order	chrono / alpha	chrono si layout=screenings alpha si layout=events	Définit le tri par ordre chronologique ou alphabétique
section_ids	ID_section1,…2,…3,….		Utile si on veut sélectionner une section en particulier
xsection_ids	ID_section1,…2,…3,…		Utile si on veut exclure une section en particulier
day	2020-12-1		Définit la date des évents ou screenings à afficher
tags	Tag1,..2,..3		Filtre les événements par tag
screening_section_ids	ID_sreenings1,..2,…3,…		Filtre la section des séances à afficher
top_filter	Screenings | events		Définit le filtre entre les films ou séance
places	ID_salle1,..2 ,..3,…		Affiche les événements en fonction des salles
filter_fields	Label | value |…		Filtre sur les événements en fonction d’un tableau de filtre

Exemples de templates :

– list : affichage en liste avec une image et une description à la suite comme ci-dessous.

– grid : affichage de l’event ou du screening avec une image et le texte en dessous, le nombre de colonnes est définies par l’attribut item_width décrit un peu plus bas.

– gallery : affichage uniquement des images.

9.8.6.Affichage de la prochaine séance

[tkt_next_screening output=“title“ with_link=“1“ places=“12345678-1234-1234-1234-123456789012″][/tkt_next_screening]

Attributes :

Attributes	Possibles values	Value by default	Description
output	title|date|time|datetime|venue|poster|url		Affiche le champs séléctionné
with_link	0 | 1	1	Affichage avec lien
places	ID_place1,…2,…3,…		Affichage des séances par salles

9.8.7.Filtres

Filtre par jour :

[tkt_days_filter][/tkt_days_filter ]

Ce shortcode affiche une barre de filtres par jour et permet de filtrer les séances par leur date de
début.
Description des attributs :

Attribut	Valeurs possibles	Valeur par défaut	Description
min_start_at	aaaa-mm-jj	Date du jour	Premier jour de la barre de filtres
max_start_at	aaaa-mm-jj	Date du jour	Dernier jour de la barre de filtres
nb_days	Nombre_de_jour		Nombre de jours dans la barre de filtres4

Lignes de filtres :

[tkt_filter_rows row-hall=“Salle 1|Salle 2|Salle 3″ row-next-days=“7″][/tkt_filter_rows]

Description des attributs :

Attribut	Valeurs possible	Valeur par défaut	Description
row-hall	Salle1 | Salle 2| Salle 3| …		Permet de créer une ligne de filtre sur les salles
row-next-days	7		Permet de créer une ligne de filtre sur les X jours à venir

Achat d’abonnements

[tkt_buy_pass][/tkt_buy_pass]

Description des attributs :

Attribut	Valeurs possibles	Valeur par défaut	Description
Redirect	none | cart| tkt_cart |tkt_checkout	none	Redirection après l’achat d’un abonnement
types	ID_type1,…2,…3,…		Choisit le ou les types d’abonnement à afficher

Formulaire de connexion avec un TicketID

[tkt_ticket_connect][/tkt_ticket_connect]

Ce shortcode ne nécessite aucun attribut

Formulaire d’authentification avec un utilisateur

[tkt_user_login][/tkt_user_login]

Ce shortcode ne nécessite aucun attribut

Validation de la commande

[tkt_checkout][/tkt_checkout]

Attribut	Valeurs possibles	Valeur par défaut	Description
Fields	Firstname, lastname,email,adress,…		Définit les champs à remplir par l’utilisateur lors d’achat d’article.

Affichage de la boutique

[tkt_shop][/tkt_shop]

Description des attributs :

Attributs	Valeurs possibles	Valeur par défaut	Description
template	list | grid | gallery	list	Définit le type d’affichage (cf : choix du template)
category_ids	ID_category1,…2,…3 ,…		Définit la/les catégorie(s) d’articles à afficher
item_width	12/nb_colonnes	12	Définit la taille d’affichage des articles
hide_sorters	0 | 1	1	Affiche le tri possible
only_in_stock	0 | 1	1	Choisit d’afficher les articles disponible ou non
nb	nb_tot_article_affiché	-1 (permet d’afficher tout les articles)	Choisit le nombre total d’article à afficher
exclude	ID_article1,..2,..3,…		Exclu des articles en fonction de leur ID
sort	alpha | rev-alpha | incr_price | decr-price | random		Permet de trier les articles
show	0 | 1	0	Créer une pagination
tkt_page	numéro_de_page	1	Définit le numéro de page à afficher
nb_by_page	nb_article_par_page	9	Définit le nombre d’article par page

Personnalisation du rendu et du style

Si le rendu (visuel, informations affichées, etc.) des shortcodes fournis ne vous convient pas, vous avez la possibilité de les surcharger dans votre propre thème.

Feuille de style (style.css)

Afin de modifier l’apparence de votre site à votre guise rendez-vous dans : apparence → Personnalisation → CSS additionnel. Ici vous pouvez écrire au format CSS le style que vous souhaitez modifier.

Surcharge du rendu des shortcodes

Les templates d’origine du plugin Ticketack se trouvent dans wp-content/plugins/ticketack/app/templates/. Chacun des dossiers contenu dans ce répertoire gère l’affichage d’un shortcode.

Pour surcharger le style d’une partie votre site générée par un des shortcodes précédemment décrits, il vous faut créer à la racine de votre thème un dossier ticketack ainsi qu’un dossier templates à l’intérieur de ce dernier.

Vous pouvez ensuite surcharger l’affichage d’un shortcode en copiant le dossier correspondant depuis wp-content/plugins/ticketack/app/templates/ vers wp-content/themes/[votre_theme]/ticketack/templates/, puis en modifiant les fichiers de templates..

Voici une liste exhaustive des dossiers que vous pouvez surcharger :

• article : Modifie la vue d’un article.
• booking : Modifie la vue des réservations.
• buy_article : Modifie la vue d’achat d’un article.
• buy_pass : Modifie la vue d’achat d’abonnement.
• cart : Modifie la vue du panier.
• checkout : Modifie la vue de validation de commande
• event : Modifie la vue d’un film.
• filter : Modifie la vue des filtres.
• next_screenings : Modifie la vue des prochaines séances.
• people : Modifie la vue
• program : Modifie la vue de la programmation
• shop : Modifie la vue du shop.

Important : avertissement lors de mises à jour de votre thème

Il est fortement conseiller de travailler sur un thème enfant afin de ne pas perdre vos modifications de style lors des mises à jour du thème.

Un thème enfant est un thème basé sur votre thème parent. Il en reprend toutes les fonctionnalités sans jamais le modifier. Ainsi vous pouvez apporter des modifications à votre thème enfant et en cas de mise à jour du parent, vous ne les perdez pas !

Tout fichier placé dans le thème enfant et portant le même nom que dans le thème parent, prendra le dessus et écrasera le fichier d’origine (sauf functions.php).

Utilisation avec un plugin de cache

Si vous utilisez un plugin de cache comme Comet Cache et la fonction de proxy image, les images provenant de Ticketack sont optimisées en fonction du navigateur et peuvent être convertie dans le format WebP qui n’est pas supporté par certains navigateurs. Il est ainsi nécessaire de configurer votre plugin de cache pour générer une version des pages pour les navigateurs qui supportent ce format et une version pour ceux qui ne le supportent pas.

Exemple de configuration pour Comet Cache Pro :

Create a Dynamic Version Salt For Comet Cache :

(strpos( $_SERVER[‚HTTP_ACCEPT‘], ‚image/webp‘ ) !== false ? ‚webp‘ : “)