Voir la source de Installation CiviCRM sur serveur Debian

=Prérequis=
*Debian 11 
*Apache

Ne pas utiliser les paquets Debian Wordpress ni CiviCRM qui organisent les fichiers différemment de ce qui est attendu dans la doc

=Installation serveur LAMP=
==PHP==
Testé avec PHP 7.4.33 (cli) (built: Nov  8 2022 11:40:37) ( NTS )
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">apt-get install php composer libapache2-mod-php php-pear php-cgi php-common php-mbstring php-zip php-net-socket php-gd php-xml-util php-mysql php-bcmath php-intl php-imagick unzip wget curl git -y</blockquote>
Vérifier que la ligne 
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">;extension=intl</blockquote>
est bien décommentée dans /etc/php/VERSION/apache2/php.ini ET /etc/php/VERSION/cli/php.ini

==Mariadb==
*Installer Mariadb (au moins v. 10.5 sinon certaines requetes ne marchent pas) et phpmyadmin
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">apt-get install mariadb-server mariadb-client phpmyadmin -y</blockquote>
*Démarrer Mariadb
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">systemctl start mariadb</blockquote>
*Faire démarrer Mariadb à chaque reboot
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">systemctl enable mariadb</blockquote>
*Sécuriser madiadb
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">mysql_secure_installation</blockquote>
Entrez les informations : mdp root Mariadb, suppression utilisateurs anonymes, désactiver accès root distants, supprimer base test :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">Enter current password for root (enter for none):<br />Change the root password? [Y/n] Y<br />New password: <span style="color: red;"><MARIADBPASSWD></span><br />Remove anonymous users? [Y/n] Y<br />Disallow root login remotely? [Y/n] Y<br />Remove test database and access to it? [Y/n] Y<br />Reload privilege tables now? [Y/n] Y</blockquote>
*Mettre en place la timezone puis redémarrer Mariadb
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql<br />systemctl restart mariadb</blockquote>

=Installation Wordpress=
==Création de la base de données==
*Créer un ficher qui va générer une base de donnée wordpress avec un mot de passe <span style="color: green;"><WORDPRESSPASSWD></span>
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">nano ~/wp.sql<br />CREATE DATABASE wordpress;<br />GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER<br />ON wordpress.*<br />TO wordpress@localhost<br />IDENTIFIED BY '<span style="color: green;"><WORDPRESSPASSWD></span>';<br />FLUSH PRIVILEGES;</blockquote>
*Créer la base de données
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cat ~/wp.sql | mysql --defaults-extra-file=/etc/mysql/debian.cnf</blockquote>

==Télécharger Wordpress et installer le site ddctest==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html<br />wget https://wordpress.org/latest.zip<br />unzip latest.zip<br />mv wordpress ddctest</blockquote>
Attention pas de caractères spéciaux dans le nom du site !

==Éditer le ficher de configuration utilisé par Wordpress lors de l'installation==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd ddctest<br />cp wp-config-sample.php wp-config.php<br />nano wp-config.php</blockquote>
Change the following lines that match your database settings:
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">/** The name of the database for WordPress */<br />define( 'DB_NAME', 'wordpress' );<br />/** MySQL database username */<br />define( 'DB_USER', 'wordpress' );<br />/** MySQL database password */<br />define( 'DB_PASSWORD', '<span style="color: green;"><WORDPRESSPASSWD></span>' );<br />/** MySQL hostname */<br />define( 'DB_HOST', 'localhost' );<br />define('FS_METHOD', 'direct');</blockquote>

== Changer les permissions ==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">chown -R www-data:www-data /var/www/html/ddctest</blockquote>

== Créer le site==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /etc/apache2/sites-available <br />cp 000-default.conf ddctest.conf<br />nano ddctest.conf<br />change :  DocumentRoot /var/www/html/ddctest<br />change :  ServerAdmin mailadmin@domaine.fr</blockquote>
Désactiver l'hôte virtuel par défaut, activer le site et relancer le serveur web
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">a2dissite 000-default<br />a2ensite ddctest<br />service apache2 reload</blockquote>

==Installation Wordpress==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">dans un navigateur: http://ddc_test/</blockquote>

Entrer: 
*la langue
*titre du site : ddctest
*identifiant : <USERWORDPRESS>
*password : <span style="color: red;"><MDPUSERWORDPRESS></span>

=Installation CiviCRM=
==Creer base de données CiviCRM et donner tous les droits à l'utilisateur civicrm==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">mysql -uroot -p -e "CREATE DATABASE civicrm DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci"
<br />mysql -uroot -p -e "grant all on civicrm.* to 'civicrm'@'localhost' identified by '<span style="color: blue;"><MDPCIVICRM></span>'"</blockquote>

==Installer les fichiers CiviCRM==
===A partir des fichiers disponibles sur le site civiCRM===
*La documentation officielle est : https://docs.civicrm.org/sysadmin/en/latest/upgrade/wordpress/
*Récupérer les fichiers d'installation pour Wordpress : sur https://civicrm.org/fr/telecharger
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins<br />unzip civicrm-X.XX.X-wordpress.zip</blockquote>
*Récupérer les fichiers de traduction correspondant à cette version (à faire avant de lancer l'installation)
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins<br />mkdir test<br />tar xvzf civicrm-X.XX.X-l10n.tar.gz</blockquote>
*Cela crée ../cvcrm/sql et cvcrm/l10n
**naviguer dans ces deux repertoires pour ne garder que les fichiers ayant fr_RF ou FR-fr (2 dans sql et un dans l10n)
**copier l10n/ dans /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/
**copier les deux fichiers de sql dans /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/sql/

===A partir d'une archive incluant tous les fichiers===
* récupérer civicrm-X.XX.X-wordpress_FR_API_ext.zip : cette archive comporte les fichiers CIVICRM, la régionalisation fr et les extensions nécessaires
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins<br />unzip civicrm-X.XX.X-wordpress_FR_API_ext.zip</blockquote>

==Changer les permissions de CiviCRM==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins/<br />chown -R www-data:www-data civicrm</blockquote>

==Lancer l'installeur CiviCRM==
*connectez vous sur votre site Wordpress avec des permissions admin (https://ddctest/wp-admin/)
**identifiant : <USERWORDPRESS>
**password : <span style="color: red;"><MDPUSERWORDPRESS></span>
*allez dans les extensions et activez CiviCRM pour lancer l'installation
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">Langue: francais<br />modifier la base civicrm : mysql://civicrm:<span style="color: blue;"><MDPCIVICRM></span>@localhost/civicrm<br />lancer l'installation</blockquote>

==Si le site Wordpress devient inaccessible après installation de CiviCRM==
Désactivez les plugins via la base de données
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">Connectez-vous sur la base Wordpress via Phpmyadmin<br />Dans la table wp_options, colonne option_name, cherchez la ligne active plugins<br />changer la valeur pour a:0:{}<br />Rechargez la page admin de Wordpress</blockquote>

==Installation extensions de CiviCRM==
===Installation depuis un paquet préparé pour le don du corps===
les extensions sont comprises dans l'archives ; passez directement au paramétrage de CiviOffice

===Installation depuis des paquets séparés===
*Dans CiviCRM > administration > paramètres système > gérer extensions
*Verifier que les extensions suivantes sont installées :
**Contact Layout Editor(personalisation des écrans de saisie) à chercher dans onglet ajouter
**Contribution cancel actions (defaut)
**Documents (gestion documents)
**Fuzion Tokens (gère les jetons pour insertions automatiques dans les courriers)
**CiviOffice (utilise des modèles word pour la correspondance)
**civi_ddc (outils pour la gstion du don de corps - en développement)
* Installer manuellement French Codes postaux (complétion auto des adresses via API La Poste)
** Récupérer extension depuis Download the extension package https://github.com/allinappli/frenchCodePost-civicrm (inutilise si vous avez utilisé l'archive d'installation incuant les extensions; passez alors à l'étape suivante)
** Utiliser une version >=1.1 les antérieures ne marchent pas
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cp frenchcodepostaux-X.X.zip /var/www/html/ddctest/wp-content/uploads/civicrm/ext/ <br /> cd /var/www/html/ddctest/wp-content/uploads/civicrm/ext/ <br /> unzip frenchcodepostaux-X.X.zip <br /> chown -R www-data:www-data frenchcodepostaux-X.X</blockquote>
** Rechargez la page des extensions et cliquez sur installer sur FrenchCodesPostaux qui est apparue
* installer manuellement les paquets suivants : 
**Related tokens (https://civicrm.org/extensions/related-tokens): pour récupérer les informations des personnes référentes ;
**More Greetings Options (https://civicrm.org/extensions/more-greetings-personalised-strings-all-contacts): pour créer des civilités complexes par exemple extraire la civilité depuis le genre
**Dompdf-fonts (https://github.com/eileenmcnaughton/dompdf-fonts): pour imprimer correctement les docs html en pdf
**Civirules (https://civicrm.org/fr/extensions/civirules): pour parametrer les purges
**CiviCRM Configuration Loader (https://docs.civicrm.org/configitems/en/latest/): pour exporter/importer configurations
===Paramétrage de CiviOffice===
CiviOffice simplifie la gestion des modèles de document qui sont nativement gérés sous forme de messages html
* Installer l'extension CiviOffice : cf. étape précédente
* Installer unoconv : c'est un convertisseur qui génère des pdf à partir de documents word ; il a besoin de libre office qui s'installe en même temps que lui
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">apt-get update<br />apt-get install unoconv</blockquote>
* Installer la police LibreBarcode39-Regular.ttf qui sera utile pour imprimer des codes barres. Elle est téléchargeable sur Google Fonts
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cp LibreBarcode39-Regular.ttf /usr/local/share/fonts/<br />chmod 644 /usr/local/share/fonts/LibreBarcode39-Regular.ttf<br />fc-list | grep LibreBarcode39</blockquote>
La dernière commande vérifie que la police est bien disponible ; elle doit retourner son chemin.
* Paramétrer CiviOffice
Comme administrateur allez dans CiviOffice > Settings

[[File:civioffice_menu.png|300px]]

==Modification de Tokens.php (pour récupérer la date de décès)Pas nécéssaire depuis 5.65.2==
La date de décès n'est pas disponible sous forme de jeton à insérer dans les messages. Pour l'ajouter il faut : 
*editer wp-content/plugins/civicrm/civicrm/CRM/Contact/Tokens.php

<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">nano wp-content/plugins/civicrm/civicrm/CRM/Contact/Tokens.php<br />ajoutez 'deceased_date’,<br /> au dessous de 'birth_date',:<br/>...<br/>'birth_date',<br/>'deceased_date',<br/>'employer_id',<br/>...</blockquote>
*vider le cache Administrer > Paramètres système > Effacer les caches
*vider le cache 
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">rm -rf /var/www/html/ddctest/wp-content/uploads/civicrm/templates_c/* </blockquote>

==Créer utilisateurs - Régler les permissions==
* Créer des utilisateurs dans Wordpress, par privilèges décroissants: administrateurs (tous les droits), auteurs, contributeurs
* Les récupérer dans CiviCRM : administration > utilisateurs et permissions > synchroniser
** crée un utilisateur CiviCRM par utilisateur Wordpress
*Gérer les permissions
** Les permissions dans CiviCRM sont gérées par le statut dans Wordpress:
*** admin ont tous les droits
*** auteurs : gestionnaires dans CiviCRM
*** contributeurs : visu sans modification dans CiviCRM
** Les permissions sont réglées finement dans : civiCRM > administration > utilisateurs et permissions > permissions > Wordpress control access
** Les permissions types sont :

[[File:Reglage ACL Civicrm.jpg]]

== Créer une page d'accueil montrant la liste des donneurs==
Une telle page est pratique pour avoir une vue synthétique ; elle peut par exemple être la cible d'un bouton sur la page d'accueil du site Wordpress
YOURSITE/wp-admin/admin.php?page=CiviCRM&q=civicrm%2Fcontact%2Fsearch&force=1&qfKey=0

== Programmer l'exécution des tâches périodiques (Sinon vous aurez une alerte système et ne pourrez envoyer des mails en masse==
*CiviCRM gère des taches périodiques avec une fréquence définie dans Administrer > Paramètres Systèmes > Travaux programmés
*Ces tâches sont exécutées via une API, job.execute, qui utilise un utilisateur crontab (administrateur de wordpress) pour interagir avec CiviCRM via wp-cli, le langage de communication avec Wordpress.
*Cette metatache programmée, job.execute, est elle même lancée par www-data via cron à une période choisie par l'utilisateur.
Pour plus d'infos : https://docs.civicrm.org/sysadmin/en/latest/setup/jobs/

=== Installer wp-cli===
*Créer un utilisateur cronuser dans Wordpress, avec les privilèges Admin
*Installer le package wp-cli.phar dans /usr/local/bin/ et le renommer wp
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">sudo su<br />cd<br />curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar<br />php wp-cli.phar --info (vérifie que tout est ok)<br />mv wp-cli.phar /usr/local/bin/wp <br /> chmod ugo+x /usr/local/bin/wp</blockquote>
*Tester le lancement manuel de l'API job.execute par l'utilisateur www-data et l'utilisateur cronuser de Wordpress
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">sudo -u www-data /usr/local/bin/wp --user=cronuser --url=http://SITE --path=/var/www/html/ddctest civicrm api job.execute auth=0</blockquote>

*Remplacer :
**SITE par l'adresse de votre site
**/var/www/html/ddctest par le chemin ou sont situés les fichiers de votre site
*Normalement les taches s’exécutent et sont listés dans les journaux accessibles dans Administrer > Paramètres Systèmes > Travaux programmés

=== Définir la périodicité d'exécution de job.execute par cron===
Pour lancer job.execute toutes les 5 minutes
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">crontab -e -u www-data<br />ajouter cette ligne dans le cron de www-data<br />*/5 * * * *  /usr/local/bin/wp --user=cronuser --url=http://ddc-test --path=/var/www/html/ddctest civicrm api job.execute auth=0 </blockquote>
Remplacer 
/usr/local/bin/wp --user=cronuser --url=http://SITE --path=/var/www/html/ddctest civicrm api job.execute auth=0
Par la ligne testée plus haut (remplacer CHEMIN et SITE)

=== Définir les tâches périodiques à réaliser===
* Dans Administrer > Paramètres Systèmes > Travaux programmés 
* Choisir les taches à faire tourner automatiquement, par exemple :
**CiviCRM update check (quotidienne), 
**Clean-up temporary Data and files (horaire), 
**Send Scheduled Mailings (Always, c'est à dire à chaque fois que job.execute est lancé)
*Toutes les 5 minutes (délai d’exécution de job.execute par cron), job.execute les tâches programmées selon la périodicité définie ici
* vous pouvez vérifier le bon déroulement des tâches programmées dans les Journaux accessibles dans Administrer > Paramètres Systèmes > Travaux programmés

== Limiter les répertoires lisibles (Sinon alerte système périodique)==
Pour gérer les permissions des fichiers de CiviCRM il est proposé d'activer .htaccess
(cf. https://civicrm.org/advisory/civi-sa-2014-001-risk-information-disclosure)

<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">nano /etc/apache2/apache2.conf</blockquote>
Naviguez dans le fichier jusqu’aux lignes suivantes :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;"><Directory /var/www/><br />Options Indexes FollowSymLinks<br />AllowOverride None<br />Require all granted<br /></Directory></blockquote>
Changer : <blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">AllowOverride None</blockquote>
Par :<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">AllowOverride All</blockquote>
Relancer Apache2
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">systemctl restart apache2</blockquote>

=Migration base données civiCRM=  
Important : Les versions civiCRM des serveurs source et cible 
*DOIVENT ÊTRE IDENTIQUES (le format des bases change avec la version) 
*Avec les mêmes extensions
==Sur le serveur source==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">mysqldump -u <civicrm_source_base_user> -p <civicrm_source_base> > <civicrm_sourcebase.sql><br />avec :<br /><civicrm_source_base> : base à exporter<br /><civicrm_source_base_user> : utilisateur de la base à exporter<br /><civicrm_sourcebase.sql> : nom du fichier d'export</blockquote>

==Sur le serveur cible==
*Wordpress > Extensions > CiviCRM : désactiver
*Dans PhpMyadmin : 
** Supprimer toutes les tables de la base civicrm
** Importer la base sauvegardée à l'étape précédente
** L'import peut se faire en ligne de commande pour ne pas être bloqué par les limites de taille de base par défaut de PhpMyadmin :

<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">mysql -u civicrm -p (se connecter à mysql avec le nom d'utilisateur défini ) l'installation;<br />mysql> use civicrm; (pour travailler sur la base civicrm) <br/> mysql> source sauvegarde_base_civicrm.sql<br/>mysql> exit</blockquote>
* Wordpress > Extensions > CiviCRM : activer
*Dans le menu wordpress (bandeau de gauche) : Civicrm > Settings > Rebuild the CiviCRM menu
*Dans le menu wordpress (bandeau de gauche) : Civicrm > Settings > Rebuild the CiviCRM database triggers

==Migration des documents (pdf, notes) associés aux contacts==
* Ces documents ne sont pas dans la base de donnée qui ne contient que leur chemin
* Ils sont dans /var/www/html/ddctest/wp-content/uploads/civicrm/custom/
* Il est impératif de copier ces fichiers du serveur source vers le cible

==Paramétrage des courriers==
L'import de base importe aussi les modèles de messages qui doivent être paramétrés pour s'adapter au nouveau site
*Migration des images utilisées dans les courriers (signature.png, logo.png, anddc.jpg)
** Ces images doivent être copiées lors d'une nouvelle installation dans /var/www/html/wordpress/wp-content/uploads/civicrm/persist/contribute/images
** Elles doivent être lisibles par le groupe et les autres utilisateurs :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">chmod go+r signature.png<br/>chmod go+r logo.png<br/>chmod go+r anddc.jpg<br/></blockquote>

*Modification des coordonnées de l'organisation par défaut. Ces infos seront reprises dans l'édition des courriers
**Dans Administrer > Communication > Adresse de l'organisation et infos de contact, entrer les paramètres du centre de don 
**Utilisez Rue et Complement d'adresse1 pour entrer l'adresse
**Complement d'adresse 2 correspond au directeur du centre de don : "Pr Truc, Directeur"
**Complement d'adresse 3 correspond à la secrétaire du centre de don : "Mme Machin, Secrétaire"
**Dans téléphone vous pouvez entrer plusieurs valeurs : "02 22 22 22 22 ou 02 44 44 44 44"

*Modification des templates de documents avec l'interface. 
**Mailing > Modèles de messages affiche la liste des messages utilisables pour générer des documents (courriels ou pdf). Ces modèles html stockés dans la base contiennent des liens absolus vers les images incluses dans les messages qui doivent être modifiés :
** pour le message à modifier, cliquer sur Modifier
** dans l'éditeur cliquer sur source et remplacer les occurrences de "src="http://XX.XXX.XX.XX/wp-content/" par la valeur pour votre serveur (le plus pratique est de copier coller vers un éditeur externe pour les remplacements puis de copier-coller vers l'éditeur de CiviCrm
**cliquez sur source pour voir le résultat html, puis enregistrer
** pour vérifier le résultat, ouvrir un contact > Action > Imprimer fusionner le document > choir le modele > prévisualiser

*OU BIEN Modification des templates de documents via une requête mysql. Par exemple, pour une installation sur https://serveurnew.fr/. Attention : faire une sauvegarde de votre base en cas de problème !
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">
1 - Se connecter à mysql avec le nom d'utilisateur défini à l'installation:<br/>
mysql -u civicrm -p;<br/>
use civicrm; (pour travailler sur la base civicrm) <br/><br/>
2 - Modifier les messages html:<br/>
UPDATE civicrm_msg_template<br/>
SET msg_html = REPLACE(msg_html, 'http://XX.XXX.XX.XX/wp-content/uploads/civicrm/persist/contribute/images/', 'https://serveurnew.fr/wp-content/uploads/civicrm/persist/contribute/images/')<br/>
WHERE msg_html LIKE '%http://XX.XXX.XX.XX/wp-content/uploads/civicrm/persist/contribute/images/%';<br/><br/>
2 - Modifier les messages text s'il y a lieu:<br/>
UPDATE civicrm_msg_template<br/>
SET msg_text = REPLACE(msg_text, 'http://XX.XXX.XX.XX/wp-content/uploads/civicrm/persist/contribute/images/', 'https://serveurnew.fr/wp-content/uploads/civicrm/persist/contribute/images/')<br/>
WHERE msg_text LIKE '%http://XX.XXX.XX.XX/wp-content/uploads/civicrm/persist/contribute/images/%';</blockquote>

* De la même façon vous pouvez changer les couleurs utilisées dans les documents en modififiant leurs codes hexa dans les templates. 
** Deux couleurs sont utilisées, pour les documents généraux et les cartes de donneur d'une part, et pour les cartes de référents d'autre part.
** Ces couleurs sont à choisir selon la charte graphique de l'université. Vous pouvez utiliser https://www.rgbtohex.net/ pour convertir une valeur RGB en hexa
** Par exemple si vous souhaitez remplacer la couleur #B95FFC par #009DE0
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">
1 - Se connecter à mysql avec le nom d'utilisateur défini à l'installation:<br/>
mysql -u civicrm -p;<br/>
use civicrm; (pour travailler sur la base civicrm) <br/><br/>
2 - Modifier les messages html:<br/>
UPDATE civicrm_msg_template<br/>
SET msg_html = REPLACE(msg_html, 'B95FFC', '009DE0')<br/>
WHERE msg_html LIKE '%B95FFC%';<br/><br/>
2 - Modifier les messages text s'il y a lieu:<br/>
UPDATE civicrm_msg_template<br/>
SET msg_text = REPLACE(msg_text, 'B95FFC', '009DE0')<br/>
WHERE msg_text LIKE '%B95FFC%';</blockquote>

*Pour que le système utilise correctement les pdf (sinon il remplace les cases à cocher par des "?" à l'impression
** Allez dans Administrer > Console d'administration > Paramètres Système > Divers (Restaurer, PDFs, limites, Journalisation, etc)
** "Dossier des polices de DOMPDF" contient une entrée du type : /home/u530985180/public_html/14/wp-content/plugins/civicrm/civicrm/ext/dompdf-fonts-master/Managed/../fonts
** La modifier pour pointer vers le chemin de votre installation (par ex /var/www/html/wordpress/wp-content/plugins/civicrm/civicrm/ext/dompdf-fonts-master/Managed/../fonts)

=Paramétrage des purges de la base de données=
L'article 4 de [https://www.legifrance.gouv.fr/download/pdf?id=i18Wkuyn4Vl70eYdM8iDKjj6UFbgHwXsc1xpBHveUmo= l'arrêté du 22 juillet 2023] précise les conditions de conservation des données liées aux donneurs, aux proches et aux utilisateurs du centre de don du corps.
La purge des données comporte plusieurs étapes :
* Requêtes utilisant SearchKit pour rattacher les contacts à des groupes dynamiques (par exemple donneurs dont les opérations funéraires sont achevées depuis plus de 5 ans, Dons annulés...
* Purge des contacts de chacun des groupes en appliquant des règles différentes, définies par l'arrêté. Cette purge est réalisée par une API (apiv4_PurgeCDC-X.X.php
== Mise à jour de votre version de CiviCRM==
Utilisez un paquet fourni incluant les extensions et les API >= civicrm-5.68.1-wordpress_FR_API_ext
== Installation de cv==
cv est une interface en ligne de commande pour interragir avec CiviCRM. Son installation est indispensable à utilisation des API
* vérifiez que cv n'est pas installé en tapant cv dans un terminal
* Si cv n'est pas installé, récupérez [https://download.civicrm.org/cv/cv.phar cv.phar]
* Installez le dans un répertoire inclut dans $PATH, par exemple 
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">sudo mv cv.phar /usr/local/bin/cv<br/>
sudo chmod +x /usr/local/bin/cv </blockquote>
* Si vous tapez cv, une aide va s'afficher

==Création des champs personnalisés, des menus et des requêtes (inutile pour les bases distribués à partir du 1/1/2024)==
Pour bases fournies après le 1/1/24 passez cette étape.
===Création des champs liés aux personnels===
La gestion des personnels de centres impose l'enregistrement de leurs dates d'arrivée et de départ, les données les concernant étant purgées 5 ans apres leur départ. Ces champs n'avaient initialement pas été prévus. Pour les créer:
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/api/<br/>php apiv4_Create_dates_Personnels_et_MenusPurge.php</blockquote>
Pour vérifier la création des champs, allez dans Administrer > Personnaliser les données et écrans > Champs personnalisés. 

[[File:Aff_champs_perso.jpg|800px]]

Le groupe de champs Informations Personnels apparait en bas de liste. Il comporte deux champs de date.

[[File:Res_champs_perso.jpg|800px]]

===Création/import des requêtes SearchKit===
Vous devez importer les requêtes SearchKit nécessaires aux purges. Si elles existent déjà, elles seront mises à jour.
* Ouvrez SearchKit (Recherchez > SearchKit)
[[File:SearchKit.jpg|600px]]

* La liste des Requêtes s'ouvre ; cliquez sur Import
[[File:SearchKit_list.jpg|800px]]

* une fenêtre s'affiche afin que vous y copiez le code de la requête ; cliquez ensuite sur Import. 
[[File:SearchKit_import.jpg|800px]]

* Les requêtes suivantes doivent être importées:
**Personnels partis depuis plus de 5 ans
**Donneurs DC > un an et refus
**Donneurs dont op funéraires > 1 an
**Donneurs annulés
**Demandeurs d'informations plus d'un an
**Donneurs > 120 ans
**Anonymisés (résultat des purges)
**Proches sans relations

* Ces requêtes apparaissent dans la liste et chacune est liée à un groupe dynamique
[[File:SearchKit_result.jpg|800px]]

== Lancer les purges==
ATTENTION, CETTE OPÉRATION EST IRRÉVERSIBLE. IL EST PRÉFERABLE DE FAIRE UNE SAUVEGARDE DE LA BASE DE DONNÉES PRÉALABLE.<br/>
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/api/<br/>php apiv4_PurgeCDC-1.0.php</blockquote>
Les listes de purges sont vidées et les contacts sont supprimés ou leur identité est modifiée pour Anonymisé ANONYMISE

=Mises à jour=
==Avant mise à jour==
*Dans Worpress desactivez l'extension CiviCRM
*<span style="color: red;">Sauvegarder</span>
** <span style="color: red;">Site</span>
** <span style="color: red;">Base de données</span>
** <span style="color: red;">Ne pas oublier : /var/www/html/ddctest/wp-content/uploads/civicrm/custom/</span>
** <span style="color: red;">Le répertoire extension qui devra être restauré en fin d'installation</span>
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cp /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/ext/ Backup_loin_du_site_ext_bkp</blockquote>
* pour les installations récentes, le fichier civicrm.settings.php contient une ligne pour définir la variable php `auto_detect_line_endings`. Il est obsolète et la ligne doit être supprimée du fichier.
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">nano /var/www/html/ddctest/wp-content/uploads/civicrm/civicrm.settings.php </blockquote>
Recherchez auto_detect_line_endings et commentez les lignes
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">// force PHP to auto-detect Mac line endings<br />//if (version_compare(PHP_VERSION, '8.1') < 0) {<br />//  ini_set('auto_detect_line_endings', '1');<br />//}</blockquote>
* Dans CiviCRM, nettoyez la base et les caches :
[[File:Clean_Civicrm.jpg|800px]]

== Effacer les anciens fichiers==
Effacer fichiers existants pour civicrm et son cache
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">rm -rf /var/www/html/ddctest/wp-content/plugins/civicrm <br />rm -rf /var/www/html/ddctest/wp-content/uploads/civicrm/templates_c/* </blockquote>
ATTENTION: ne pas effacer : /var/www/html/ddctest/wp-content/uploads/civicrm/custom qui contient les document liés aux contacts

==Installer les nouveaux fichiers (idem installation)==
===A partir des fichiers disponibles sur le site civicrm===
*La documentation officielle est : https://docs.civicrm.org/sysadmin/en/latest/upgrade/wordpress/
*Récuperer les fichiers d'installation pour wordpress : sur https://civicrm.org/fr/telecharger
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins<br />unzip civicrm-X.XX.X-wordpress.zip</blockquote>
*Récupérer les fichiers de traduction correspondant à cette version (à faire avant de lancer l'installation)
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins<br />mkdir test<br />tar xvzf civicrm-X.XX.X-l10n.tar.gz</blockquote>
*Cela crée ../cvcrm/sql et cvcrm/l10n
**naviguer dans ces deux repertoires pour ne garder que les fichiers ayant fr_RF ou FR-fr (2 dans sql et un dans l10n)
**copier l10n/ dans /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/
**copier les deux fichiers de sql dans /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/sql/

===A partir d'une archive incluant les fichiers de régionalisation, les API et les extensions ===
* récupérer civicrm-X.XX.X-wordpress_FR_API_ext.zip : cette archive comporte les fichiers CIVICRM, la régionalisaiton fr, les extensions dans leur version récente
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins<br />unzip civicrm-X.XX.X-wordpress_FR_API_ext.zip</blockquote>

==Changer les permissions de CiviCRM==
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cd /var/www/html/ddctest/wp-content/plugins/<br />chown -R www-data:www-data civicrm</blockquote>

==Restaurer les extensions==
A faire même si vous avez utilisé une archive incluant les extensions : la version ancienne est nécessaire à la mise à jour de CiviCRM ; les extensions se mettent à jour ensuite
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">cp Backup_loin_du_site_ext_bkp /var/www/html/ddctest/wp-content/plugins/civicrm/civicrm/ext/ </blockquote>

==Lancer l'installeur==
* Dans wordpress activer l'extension civicrm
* aller sur : http://example.org/wp-admin/admin.php?page=CiviCRM&q=civicrm/upgrade&reset=1
**accepter la mise à niveau de votre base de donnée
**les nouveaux fichiers sont installés et la base upgradée
**recharger la page d'accueil de civicrm
* si la maj de la base de donnée ne se lance pas, dans le badeau de gauche de wordpress, sous CiviCRM, cliquez sur Settings, puis Upgrade CiviCRM

[[File:Upgrade_Civicrm.jpg|800px]]

=Trucs et astuces=

==Ajouter une commande dans les menus pour afficher tous les contacts==
*Dans Administrer > Personnaliser les données et les écrans  > Menus de navigation
*Naviguer dans l'arborescence pour trouver l'emplacement auquel vous voulez ajouter le menu (par ex rechercher)
*clic droit > Ajouter
*Mettre le titre souhaité et dans l'URL : localhost:8888/wordpress/civicrm/contact/search?force=1&qfKey=0
*Le menu est créé et point sur la page d'affichage des contacts. 
*l'adresse affichée dans la& barre de navigation peut etre utilisée pour atteindre cette page, par exemple depuis la page d'accueil Wordpress; au login l'utilisateur sera dirigé vers elle.

==Réinitialiser la numérotation des contacts (ID)==
Civicrm utilise un contact ID qui s'incrémente à chaque entrée. Si vous effacez définitivemnt tous les contacts d'une base, l'incrémentation va continuer. Pour éviter cela:
* Supprimez tous les contacts:
** Pour cela il faut supprimer tous les évenements, encaissements adhésions: faire une recherche et tous les selectionner pour suppression
** Puis supprimer les contacts : afficher la liste, tout selectionner, action : supprimer définitivement
** Supprimer ceux qui seraient en corbeille : recherche avancée, cocher chercher dans la corbeille, supprimer définitivement les résultats
** Tous les contacts vont être supprimés sauf l'utilisateuur connecté et l'organisation principale
* Allez dans PhpMyadmin, sur la table civicrm_contacts, onglet SQL, et lancer :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">ALTER TABLE civicrm_contact AUTO_INCREMENT = 1</blockquote>

==Changer le timeout de wordpress==
Lors de l'import de grosses bases, WP interrompt le processus en raison d'un timeout trop court (30 sec par défaut). Ce parametre peut être changé dans php.ini
* Pour localiser php.ini dans un terminal (https://codup.co/where-is-php-ini-in-wordpress-how-to-locate-and-edit-php-ini/#1-3), taper :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">php -i | grep php.ini</blockquote>
* Dans ce fichier, modifier la ligne :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">max_execution_time=30;</blockquote>
en remplaçant 30 par 0 pour désactiver cette limite
* Une fois l'import terminé, N'OUBLIEZ PAS DE REMETTRE LA VALEUR INITIALE

==Changer les limites de memoire de phpMyAdmin==
Lors de l'import de grosses bases, phpMyAdmin interrompt le processus en raison d'une taille trop importante. Ce parametre peut être changé dans php.ini
* Pour localiser php.ini dans un terminal (https://codup.co/where-is-php-ini-in-wordpress-how-to-locate-and-edit-php-ini/#1-3), taper :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">php -i | grep php.ini</blockquote>
* Dans ce fichier modifier 3 entrées:
**memory_limit
**post_max_size
**upload_max_filesize
Les valeurs entrées doivent être telles que memory_limit > post_max_size > upload_max_filesize
* Relancez le serveur Apache

==Problème de réglage de serveur de courrier sortant==
Lors de l'import d'une base existante, elle contient des valeurs de serveur et notamment des infos sur les clés utilisées. Ces infos peuvent être discordantes avec celles contenues dans civicrm.settings.php. lorsque vous tentez de paramétrer le serveur de courrier vous avec l'erreur 
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">Failed to find key by ID or tag (dQ4Av82utXEH28r_ebThCb2L8Y8)</blockquote>
Pour régler le problème :
* dans PhpMyadmin, ouvrir la table civcrm_setting
* rechercher l'entrée mailing_backend
* effacer sa valeur
* redéfinir les paramètres smtp dans les menus de CiviCrm : Administrer > Paramètres Système > Courrier sortant

[[File:smtp.png|1200px]]

==Créer une archive zip sans fichiers cachés mac==
Lors de la création d'archives zip avec l'utilitaire mac, des fichiers (.DS_Store) et répertoires (.__MACOSX/) cachés sont créés. Pour l'éviter:
* utilisez zip au lei de l'utilisatire Mac, cela évitera la création des répertoires .__MACOSX/
* excluez les fichiers .DS_Store :
<blockquote style="background-color: darkgrey; border: solid thin grey;color: black;">zip -r civicrm-X.XX.X-wordpress_FR_API_ext.zip civicrm/ -x '**/.DS_Store'</blockquote>