Installation de CiviCRM en français dans WordPress, avec wamp

Dewy.fr » Blog » CiviCRM » Installation de CiviCRM en français dans WordPress, avec wamp

Dans cet article je vais décrire les différentes étapes d’installation du crm open source CiviCRM dans WordPress. Pour faire cette installation, j’utilise wampserver (dernière version du logiciel soit 3.3.0). L’utilisation de cet outil est un peu old school mais j’ai essayé d’utiliser local de flywheel pour cet article sans succès malheureusement. Dans l’idéal je devrais utiliser docker. Je viens de trouver le sujet de mon prochain article 🙂

Les pré requis pour utiliser CiviCRM dans WordPress

Avant de foncer tête baissée dans l’installation du CRM dans notre CMS préféré, il est nécessaire de vérifier les pré requis pour CiviCRM. La documentation est bien faîtes et on peut trouver l’information facilement via le lien suivant : requirements CiviCRM

Pour faire fonctionner correctement CiviCRM avec WordPress, il faut un environnement serveur avec le langage PHP et une base de donnée (mysql ou maria DB). Concernant le langage PHP, la version 5.40 de CiviCRM est compatible avec PHP 8.0. La version 5.55 du CRM supporte la version PHP 8.1.

Le core de CiviCRM est compatible avec les dernières versions de PHP. Par contre, certaines extensions de l’écosystème CiviCRM peuvent avoir un peu de retard dans la compatibilité avec les dernières versions du langage PHP

Dewy

En résumé, pour cette installation en local, j’utilise les versions suivantes :

• la dernière version de WordPress
• le langage PHP 8.1.14
• MySQL 8.0.19

Avant de se lancer dans l’installation, il faut vérifier la présence d’extension PHP nécessaire pour un fonctionnement optimal de CiviCRM. Voici les librairies PHP nécessaires

• PHP BCMath
• PHP Curl
• PHP DOM XML
• PHP Multibyte
• PHP Zip
• PHP INTL
• PHP File Information
• PHP Soap

Avant l’installation j’ai également changé quelques paramètres dans le php.ini :

• memory_limit 256M
• max_execution_time 240
• max_input_time 120
• post_max_size and upload_max_filesize 50M
• max_input_vars = 4000

Téléchargement de CiviCRM

Mon environnement local fonctionne correctement, je dois télécharger l’archive CiviCRM sur le site officiel. Vous pouvez récupérer l’archive sur le site suivant : Télécharger CiviCRM. Sur cette page vous avez un menu déroulant vous permettant de télécharger les sources pour différents CMS comme Drupal, Joomla, Backdrop et WordPress.

Pour notre environnement local, je souhaite utiliser la version 5.57.1 de CiviCRM pour WordPress.

Installation de CiviCRM en français dans WordPress

Nativement le CRM est uniquement proposé en anglais. Il faut paramétrer les nouveaux langages lors de l’installation. On peut faire cette manipulation après installation, mais cela est un peu plus laborieux. L’installation de nouvelles langues se fait plus facilement dès la première initialisation de CiviCRM. Pour avoir l’outil CRM en français, je dois télécharger les fichiers de traductions pour la dernière version du crm. L’archive avec ces fichiers de traduction est disponible dans le menu déroulant.

Suite au téléchargement, je possède un fichier nommé comme ceci civicrm-5.57.1-l10n.tar.gz. Je dois le dézipper deux fois afin de visualiser les dossiers présents dans cette archive.

On peut voir un dossier l10n qui contient les chaînes traduites dans de nombreuses langues soit un dossier par langue. Par exemple, pour le français, on a un dossier fr_FR contenant un fichier json et un fichier civicrm.mo

On a également le dossier sql qui contient les configurations sql nécessaires pour une installation sans encombre dans la langue souhaitée. Pour notre cas cela sera le français.

Préparation du plugin CiviCRM pour une installation dans WordPress

Maintenant il faut préparer le plugin avec les bons fichiers de traductions. Tout d’abord, on télécharge via le menu déroulant présenté ci dessus la bonne version de CiviCRM correspondant à notre CMS. Puis, on dézippe l’archive et on va manipuler les dossiers du plugin pour insérer manuellement les fichiers de traductions.

Dans notre cas, on va prendre le dossier l10n/fr_FR et les fichiers sql inhérents à la configuration française de la base de données du crm.

1 – le dossier l10n/fr_FR doit être ajouté dans le dossier civicrm du plugin : site_root/wp-content/plugins/civicrm/civicrm/l10n/fr_FR

2 – les deux fichiers sql, civicrm_acl.fr_FR.mysql et civicrm_data.fr_FR.mysql dans le dossier sql du plugin

Suite à cette préparation du dossier on peut ajouter le plugin civicrm manuellement dans le dossier plugins de l’arborescence du site WordPress ou bien créer une nouvelle archive et utiliser l’interface d’installation d’extensions du CMS.

Le plugin est présent dans la liste des plugins mais il est inactif pour le moment. Vous devez l’activer pour profiter de toutes les fonctionnalités de ce CRM open source.

Après activation, un nouveau menu apparaît dans votre WordPress soit CiviCRM Installer. Sur cette page, il faut paramétrer l’installation de l’outil. Sur cette page, CiviCRM affiche le résultat du scan afin de vérifier si l’environnement serveur respecte tous les prérequis pour faire fonctionner ce crm open source en php. Sur cette page, j’ai également la possibilité d’installer la version française du CRM. Cela signifie que mon réglage a correctement fonctionné. Du coup je peux lancer l’installation en paramétrant les composants du crm.

Pour cette installation, je garde les composants par défaut c’est à dire

• CiviContribute
• CiviEvent
• CiviMail
• CiviMember
• CiviReport

J’ai la possibilité d’ajouter un jeu de donnée factice, mais cette option est active uniquement avec la version anglaise du crm pas pour la version française de l’outil. Enfin, le plugin détecte automatiquement les informations pour la connexion à la base de donnée. Maintenant que tout est prêt, on peut lancer l’installation.

Installation de CiviCRM dans WordPress

Si tout se passe correctement vous devez visualiser la page suivante

Enfin vous pouvez maintenant utiliser CiviCRM, via son interface

Le plugin de ce CRM apporte un nouveau menu au niveau de la barre admin native de WordPress. Vous pouvez maintenant commencer à insérer dans la base de donnée vos contacts et gérer votre association avec ce CRM open source en PHP.