424 lines
19 KiB
PHP
424 lines
19 KiB
PHP
<?php
|
||
namespace CUSTER;
|
||
|
||
/*
|
||
* it means someone outside wp is accessing the file, in this case kill it.
|
||
*/
|
||
if (!defined('ABSPATH')) {
|
||
die('You can not access this file!');
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
/*
|
||
*
|
||
*/
|
||
class Custer {
|
||
|
||
const SLUG_TOOGLE_ADMIN_MENU = ['_name'=>'toogle_admin_menu_url_custer', 'toggle'=>'toggle', 'show'=>'show', 'hide'=>'hide'];
|
||
const OPTION_TOGGLE_MENU = ['_name'=>'toggle_admin_menu_option_custer', 'show'=>'show', 'hide'=>'hide'];
|
||
const OPTION_NOTICE = [
|
||
'_name'=>'notice_usage_custer',
|
||
'_default' => [
|
||
'style'=>
|
||
'h1 {
|
||
margin-bottom: 50px;
|
||
}
|
||
h2 {
|
||
margin-top: 50px;
|
||
font-size: 1.5rem;
|
||
border-bottom: 1px solid black;
|
||
padding-bottom: 10px;
|
||
}
|
||
section {
|
||
margin-left: 20px;
|
||
}
|
||
details {
|
||
padding: 10px;
|
||
}
|
||
details.border {
|
||
border: 1px solid black;
|
||
}
|
||
summary {
|
||
cursor: grab;
|
||
}
|
||
summary:has(h2) {
|
||
margin-bottom: 50px;
|
||
}
|
||
summary > * {
|
||
display: inline;
|
||
}
|
||
pre {
|
||
white-space: pre-wrap;
|
||
}
|
||
p, summary, pre, ul {
|
||
font-size: 1.3em;
|
||
}
|
||
ul {
|
||
list-style-type: disc;
|
||
list-style-position: outside;
|
||
margin-left: 15px;
|
||
}
|
||
div:has(>ul) {
|
||
border: 1px solid black;
|
||
padding: 10px;
|
||
}
|
||
mark {
|
||
background-color: lightgray;
|
||
}
|
||
div.example {
|
||
border-left: 1px solid black;
|
||
margin-left: 20px;
|
||
padding-left: 10px;
|
||
}
|
||
.flex {
|
||
display: flex;
|
||
}
|
||
.margin-right-10 {
|
||
margin-right: 10px;
|
||
}
|
||
.margin-top-20 {
|
||
margin-top: 20px;
|
||
}',
|
||
'html'=>
|
||
'<h1>mode d\'emplois de custer</h1>
|
||
|
||
<details>
|
||
<summary><h2>1. emails : <mark>$$mot-clé$$</mark></h2></summary>
|
||
|
||
<h3>1.1. mots-clés custer</h3>
|
||
|
||
<section>
|
||
<p>dans les emails, aussi bien dans le message, que dans le sujet ou la personne destinataire, on peut utiliser un mot-clé custer.</p>
|
||
<p>Qu\'est-ce que c\'est que ça ;) ?</p>
|
||
<p>
|
||
C\'est simplement un mot-clé écrit entre doubles dollars : <mark>$$mot-clé$$</mark><br>
|
||
Lorsque un email contient ce schéma de mot entouré par des doubles dollars, il essaye de trouver la valeur associée à ce mot-clé.<br>
|
||
Ces mots-clés correspondent en fait aux données que wordpress enregistre sur chaque personne.
|
||
</p>
|
||
</section>
|
||
|
||
<h3>1.2. trouver les mots-clés</h3>
|
||
|
||
<section>
|
||
<p>Ce n\'est pas toujours facile de savoir les mots-clés qui sont disponibles, sans aller voir le code directement, donc voici un exemple de liste de mots-clés pour une utilisatrice fictive :</p>
|
||
|
||
<details class=\"border\">
|
||
<summary>exemples de mots-clés et leur valeurs (la liste exacte peut dépendre de la personne, mais cet exemple contient les valeurs les plus communes)</summary>
|
||
<pre>
|
||
admin_color : fresh
|
||
adresse_1 : 11 avenue Pauline
|
||
adresse_2 :
|
||
cgv : [\"\"]
|
||
code_postal : 92700
|
||
comment_shortcuts : false
|
||
compte-actif : Actif
|
||
description :
|
||
dismissed_wp_pointers :
|
||
display_name : AnneM
|
||
email_asso : prez@asso.fr
|
||
etablissement : École secondaire Waratinak
|
||
etat_carte : Renouvellement
|
||
etat_compte : carte valide
|
||
etat_paiement : aucun
|
||
etat_virement : [\"\"]
|
||
fin_de_validite : 19/03/2094
|
||
first_name : Anne
|
||
fonction : Prof
|
||
ID : 154
|
||
image_test_ratio :
|
||
justificatif : https://local-cipf-plugin.com/wp-content/uploads/de_fb_uploads/Attestation-1.pdf
|
||
last_name : Martin
|
||
livraison : Je préfère régler un supplément de 5 euros pour recevoir ma carte plastifiée
|
||
locale :
|
||
nickname : AnneM
|
||
niveau_denseignement : Secondaire
|
||
nom_asso : Mon asso
|
||
numero_de_la_carte : 20240403154
|
||
observations : J\'aime les bananes
|
||
paiement : Paypal
|
||
pays : Canada
|
||
photo_du_profil : https://local-cipf-plugin.com/wp-content/uploads/de_fb_uploads/Exemple_profil.jpg
|
||
president_asso : Le prez
|
||
rich_editing : true
|
||
session_tokens : {\"4003e23126f1697d7779ed03c9e45a70f2f6b34ce647a4507f573634d3c5469d\":{\"expiration\":1712437416,\"ip\":\"172.20.0.1\",\"ua\":\"Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:124.0) Gecko/20100101 Firefox/124.0\",\"login\":1712264616},\"0b63f8dbef4446bcf94af3f007df0595c8bc39095eea4c9c5042cdb066c3aeef\":{\"expiration\":1712479930,\"ip\":\"172.20.0.1\",\"ua\":\"Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:124.0) Gecko/20100101 Firefox/124.0\",\"login\":1712307130}}
|
||
show_admin_bar_front : true
|
||
somme_a_regler : 20
|
||
syntax_highlighting : true
|
||
tarif : Je suis hors réseau FIPF et je souhaite commander la carte à 15 €
|
||
telephone :
|
||
user_activation_key :
|
||
user_email : temlevorku@gufum.com
|
||
user_login : AnneM
|
||
user_login(1) :
|
||
user_nicename : annem
|
||
user_pass : $P$BwMtApJkSSYdE38By6PcLbs3Xk9crj.
|
||
user_registered : 14/03/2024
|
||
user_status :
|
||
user_url :
|
||
use_ssl :
|
||
ville : Colombes
|
||
wp_503463_capabilities : 1
|
||
wp_503463_user_level :
|
||
xoo-el-password :
|
||
xoo-el-rp-pass :
|
||
xoo-el-rp-pass-again :
|
||
xoo-el-sing-user :
|
||
xoo-el-username :
|
||
xoo_el_reg_email :
|
||
xoo_el_reg_fname :
|
||
xoo_el_reg_lname :
|
||
xoo_el_reg_pass :
|
||
xoo_el_reg_pass_again :
|
||
xoo_el_reg_terms :
|
||
xoo_el_reg_username :
|
||
__admin_email__ : hugulumu@protonmail.com
|
||
__author_page_url__ : https://local-cipf-plugin.com/author/annem/
|
||
__base_url__ : https://local-cipf-plugin.com
|
||
__user_post_url__ :
|
||
</pre>
|
||
</details>
|
||
|
||
<p>
|
||
On peut remarquer que certains mot-clés sont sous la forme <strong>\'__mot_clé__\'</strong> avec deux doubles underscores avant et apres : "__"moit-clé"__"<br>
|
||
Ce sont des mot-clés qui ne sont pas définis par worpdress de base, mais rajoutés par ce plugin (custer), plus d\'explication plus bas, dans la section suivante 1.3.
|
||
</p>
|
||
<p>Une méthode pour voir tous les mots-clés disponibles pour une personne connectée, c\'est d\'utiliser le shortcode <strong>[custer_user_info]</strong>, comme expliqué dans la partie 2 de ce mode d\'emplois.</p>
|
||
</section>
|
||
|
||
<h3>1.3. mots-clés speciaux \'__mot_clé__\'</h3>
|
||
|
||
<section>
|
||
<p>Certains mot-clés sont entourés par des doubles underscore : <strong>__mot_clé__</strong>, ce sont des mot-clés definis par custer, voici leur signification :</p>
|
||
<ul>
|
||
<li><strong>__admin_email__</strong> : l\'adresse email définie dans le menu \'Réglages\' > \'Général\' > \'Adresse e-mail d’administration\'</li>
|
||
<li><strong>__author_page_url__</strong> : la page de profil de la personne connectée, appellée \'page auteur\' par wordpress (c\'est une page un peu speciale, qui ne peut pas être construite comme les autres pages, mais par le theme directement) -> ici elle sert pour les profs, c\'est leur page de profile</li>
|
||
<li><strong>__user_post_url__</strong> : l\'adresse du plus récent article de la personne connectée -> ici ça correspond a la page de profil des partenaires, qui est construite comme un article, avec chaque partenaire n\'ayant droit qu\'à un seul article</li>
|
||
<li><strong>__base_url__</strong> : l\'url de base du site, typiquement \'www.quelque-chose.com\'</li>
|
||
</ul>
|
||
<p></p>
|
||
</section>
|
||
|
||
<h3>1.4. exemple dans un email</h3>
|
||
|
||
<section>
|
||
<p>Un exemple d\'utilisation dans un email, avec les données de l\'exemple précédent :</p>
|
||
<div>
|
||
<ul>
|
||
<li><strong>destinataire : </strong><mark>$$user_email$$</mark></li>
|
||
<li><strong>sujet : </strong>compte de <mark>$$nickname$$</mark></li>
|
||
<li><strong>message : </strong>Bonjour <mark>$$first_name$$</mark> <mark>$$last_name$$</mark>, votre carte numero <mark>$$numero_de_la_carte$$</mark> va bientot arriver a expiration, connectez-vous a votre compte pour la renouveler : <mark>$$__author_page_url__$$</mark></li>
|
||
</ul>
|
||
</div>
|
||
<p>et une fois les mot-clés convertis, cet email devient :</p>
|
||
<div>
|
||
<ul>
|
||
<li><strong>destinataire : </strong>temlevorku@gufum.com</li>
|
||
<li><strong>sujet : </strong>compte de AnneM</li>
|
||
<li><strong>message : </strong>Bonjour Anne Martin, votre carte numero 20240403154 va bientot arriver a expiration, connectez-vous a votre compte pour la renouveler : https://local-cipf-plugin.com/author/annem/</li>
|
||
</ul>
|
||
</div>
|
||
</section>
|
||
</details>
|
||
|
||
|
||
|
||
<details>
|
||
<summary><h2>2. shortcode : <mark>[custer_user_info mot-clé]</mark></h2></summary>
|
||
|
||
<h3>2.1. qu\'est-ce que c\'est ce shortcode</h3>
|
||
|
||
<section>
|
||
<p>Les shortcodes sont des \'petits codes\' qu\'on peut ecrire sur les pages front de wordpress, et qui vont executer un code côté serveur, et souvent être remplacés par le resultat de ce code.</p>
|
||
<p>C\'est à dire, plus concretement, qu\'on peut écrire un shortcode [mon-shortcode], et qu\'il se transformera en autre chose, par exemple \'salut\'.</p>
|
||
<p>
|
||
Le shortcode de custer s\'appelle \'custer_user_info\', et il permet de retrouver la valeur du mot-clé qu\'on lui donne, les mêmes mots-clés que décrits dans la partie 1 de ce mode d\'emplois, à propos des emails.<br>
|
||
Cette fois-ci, au lieu d\'ecrire le mot-clé entre double dollars <mark>$$mot_clé$$</mark>, on l\'écrit dans le shortcode : <mark>[custer_user_info mot-clé]</mark>.
|
||
</p>
|
||
<p>
|
||
Le shortcode de custer possède plus d\'options que le simple mot-clé des emails, elles sont décrites dans les sections suivantes.<br>
|
||
Mais pourquoi utiliser un shortcode ET une version avec les doubles dollars ? Tout simplement parce que dans les emails les shortcodes ne marchent pas :)
|
||
</p>
|
||
</section>
|
||
|
||
<h3>2.2. [custer_user_info]</h3>
|
||
|
||
<section>
|
||
<p>En utilisant le shortcode seul, c\'est à dire uniquement avec son nom et sans aucun autre argument : <mark>[custer_user_info]</mark>, on obtient une liste de tous les mots-clés et leur valeur de quelqu\'un. De qui ? He bien, soit de la personne connectée, soit de la personne qui à ecrit la page, mais ce point est expliqué dans la section 2.4.</p>
|
||
<p>C\'est cette méthode, le shortcode de base, qui a été utilisée pour obtenir la liste montrée plus haut dans la section email, et qui donne quelque chose comme :</p>
|
||
<div class="flex">
|
||
<p class="margin-right-10"><mark>[custer_user_info]</mark> --></p>
|
||
<pre class="margin-top-20">
|
||
display_name : AnneM
|
||
etat_compte : carte valide
|
||
fin_de_validite : 19/03/2094
|
||
first_name : Anne
|
||
fonction : Prof
|
||
ID : 154
|
||
nickname : AnneM
|
||
...
|
||
</pre>
|
||
</div>
|
||
<p>Ce n\'est pas prévu pour être vraiment utilisé sur le site finale, uniquement comme un outil pour voir les valeurs disponibles.</p>
|
||
</section>
|
||
|
||
<h3>2.3. [custer_user_info mot-clé]</h3>
|
||
|
||
<section>
|
||
<p>C\'est sous cette forme de base que le shortcode va fonctionner : afficher la valeur d\'un mot-clé.</p>
|
||
<p>Par exemple, si la prof connectée s\'appelle AnneM sur le site, on peut obtenir ce surnom en ecrivant <mark>[custer_user_info nickname]</mark></p>
|
||
<p>exemples :</p>
|
||
<ul>
|
||
<li><mark>[custer_user_info nickname]</mark> --> AnneM</li>
|
||
<li><mark>[custer_user_info first-name]</mark> --> Anne</li>
|
||
<li><mark>[custer_user_info fonction]</mark> --> Prof</li>
|
||
</ul>
|
||
<p>C\'est assez simple, cependant il y à un point important qui est expliqué dans la section suivante, c\'est de choisir de qui on affiche les infos.</p>
|
||
</section>
|
||
|
||
<h3>2.4. [custer_user_info mot-clé id=status]</h3>
|
||
|
||
<section>
|
||
<p>
|
||
Il y a un petit piège dans la version de base du shortcode avec juste le mot-clé (<mark>[custer_user_info nickname]</mark>) :<br>
|
||
on ne veut pas obligatoirement que s\'affiche les infos de la personne connectée.
|
||
</p>
|
||
<p>Comment ca ?</p>
|
||
<p>
|
||
En effet, par exemple sur une page de profil, si elle peut être vue par d\'autre personnes que simplement soi-même, alors on ne veut pas voir ses propres informations quand on va sur le profil de quelqu\'un d\'autre. Pourtant, si le shortcode affiche le nom de la personne connectée, on à beau visiter la page de quelqu\'un d\'autre, c\'est bien nous la personne connectée.<br>
|
||
Généralement les pages de profils ne sont pas visibles publiquement, mais une personne avec les droits d\'administration peut y avoir accès, et rencontrer ce probleme.
|
||
</p>
|
||
<p>Le même probleme apparait, et de manière encore plus courante, sur un article : si on veut afficher le nom de la personne qui a écrit l\'article par exemple, on ne veut pas que ce soit le nom de la personne connectée qui s\'affiche, encore une fois !</p>
|
||
<p>Donc, pour palier à ce probleme, le shortcode possede 2 status : la personne connectée, ou la personne autrice de la page.</p>
|
||
<p>Et en fait, comme la plupart du temps ce qu\'on veut ce sont les infos de la personnes qui a crée la page, le shortcode est configuré par defaut pour afficher ces infos-la, et non pas les infos de la personne connectée. C\'est ça le piège ;)</p>
|
||
<p>Donc, pour choisir si on veut la valeur de la personne connectée ou de la personne à qui appartient la page, on peut rajouter un argument : <strong>\'id\'</strong> qui peut avoir deux valeurs :</p>
|
||
<ul>
|
||
<li><strong>id=\'logged_in\'</strong> : l\'info affiché sera celle de la personne connectée</li>
|
||
<li><strong>id=\'\'author</strong> (par défaut) : l\'info affichée sera celle de la personne ayant crée la page</li>
|
||
</ul>
|
||
<p>Exemple, je suis connecté en tant que hugogogo et je vais voir la page de profil de AnneM :</p>
|
||
<ul>
|
||
<li><mark>[custer_user_info nickname]</mark> -> AnneM</li>
|
||
<li><mark>[custer_user_info nickname id=\'logged_in\']</mark> -> hugogogo</li>
|
||
<li><mark>[custer_user_info nickname id=\'author\']</mark> -> AnneM</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<h3>2.5. [custer_user_info mot-clé if_empty=value]</h3>
|
||
|
||
<section>
|
||
<p>Il y a un autre argument qu\'on peut rajouter à ce shortcode, c\'est la valeur qu\'on veut voir si le mot-clé ne trouve aucune valeur correspondante.</p>
|
||
<p>En effet, si on demande la description d\'une personne par exemple, et qu\'elle n\'est pas remplie, le shortcode va juste retourner rien du tout, par defaut.</p>
|
||
<p>Mais peut-etre qu\'on prefèrerait qu\'il affiche quelque chose comme \'description non-fournie\' ?</p>
|
||
<p>Dans ce cas c\'est très simple, il suffit de le préciser dans l\'arguement <mark>if_empty=\'description non-fournie\'</marks> (ça fonctionne avec id=\'\' aussi)</p>
|
||
<p>Exemples si Hugo visite la page d\'une personne qui n\'a pas de description, et la description de Hugo est "hugogogo est un rigolo" :</p>
|
||
<ul>
|
||
<li><mark>[custer_user_info description]</mark> -> </li>
|
||
<li><mark>[custer_user_info description if_empty=\'pas de description\']</mark> -> pas de description</li>
|
||
<li><mark>[custer_user_info description id=\'logged_in\']</mark> -> hugogogo est un rigolo</li>
|
||
<li><mark>[custer_user_info description id=\'logged_in\' if_empty=\'pas de description\']</mark> -> hugogogo est un rigolo</li>
|
||
<li><mark>[custer_user_info description id=\'author\' if_empty=\'pas de description\']</mark> -> pas de description</li>
|
||
</ul>
|
||
</section>
|
||
</details>
|
||
|
||
|
||
|
||
<details>
|
||
<summary><h2>3. shortcode : <mark>[custer_author_id]</mark></h2></summary>
|
||
|
||
<h3>3.1. qu\'est-ce que c\'est ce nouveau shortcode la ??</h3>
|
||
|
||
<section>
|
||
<p>Celui-ci est très simple, il permet de changer momentanément la valeur de la personne connectée par celle de la personne autrice de la page.</p>
|
||
<p>Pour bien comprendre, il faut d\'abord voir un exemple :</p>
|
||
<p><strong>--> connecté en tant que hugogogo, visite la page de AnneM :</strong></p>
|
||
<div class=\"example\">
|
||
<p>vous êtes connecté-e en tant que : [custer_user_info nickname id=\'logged_in\']</p>
|
||
<p>[custer_author_id]</p>
|
||
<p>vous êtes connecté-e en tant que : [custer_user_info nickname id=\'logged_in\']</p>
|
||
<p>[custer_author_id off]</p>
|
||
<p>vous êtes connecté-e en tant que : [custer_user_info nickname id=\'logged_in\']</p>
|
||
</div>
|
||
<p>ce code va donner le resultat suivant :</p>
|
||
<div class=\"example\">
|
||
<p>vous êtes connecté-e en tant que : hugogogo</p>
|
||
<p>vous êtes connecté-e en tant que : AnneM</p>
|
||
<p>vous êtes connecté-e en tant que : hugogogo</p>
|
||
</div>
|
||
<p>Qu\'est-ce qui s\'est passé ?</p>
|
||
<p>He bien en fait, lorsque le shortcode <mark>[custer_author_id]</mark> est ecrit, il modifie dans wordpress l\'information concernant la personne connectée, et il la rétablie lorsqu\'on ecrit le deuxième shortcode avec l\'argument \'off\' : <mark>[custer_author_id]</mark></p>
|
||
<p>Mais attention ! Il modifie vraiment cette valeur pour tout wordpress, ce qui peut creer des problemes avec d\'autres éléments de la page, d\'autres plugins, d\'autres bout du thème, etc... Donc, il est recommandé de ne l\'utiliser que sur une courte portion de la page, pour un acte bien précis.</p>
|
||
</section>
|
||
|
||
<h3>3.1. et pour finir, l\'argument \'important\'</h3>
|
||
|
||
<section>
|
||
<p>Et ce n\'est pas tout :p Si par hasard, vous avez besoin d\'utiliser ce shortcode sur une portion de la page, et que dans cette portion vous avez quand-même besoin de récupérer une info sur la personne connectée avec le shortcode <mark>[custer_user_info mot-clé]</mark>, la vraie personne connectée, comment faire ? Il y a une solution, en ajoutant l\'argument <strong>important</strong> au shortcode. Exemple :</p>
|
||
<p><strong>--> connecté en tant que hugogogo, visite la page de AnneM :</strong></p>
|
||
<div class=\"example\">
|
||
<p>vous êtes connecté-e en tant que : [custer_user_info nickname id=\'logged_in\']</p>
|
||
<p>[custer_author_id]</p>
|
||
<p>vous êtes connecté-e en tant que : [custer_user_info nickname id=\'logged_in\']</p>
|
||
<p>vous êtes connecté-e en tant que : [custer_user_info nickname id=\'logged_in\' important]</p>
|
||
<p>[custer_author_id off]</p>
|
||
<p>vous êtes connecté-e en tant que : [custer_user_info nickname id=\'logged_in\']</p>
|
||
</div>
|
||
<p>ce code va donner le resultat suivant :</p>
|
||
<div class=\"example\">
|
||
<p>vous êtes connecté-e en tant que : hugogogo</p>
|
||
<p>vous êtes connecté-e en tant que : AnneM</p>
|
||
<p>vous êtes connecté-e en tant que : hugogogo</p>
|
||
<p>vous êtes connecté-e en tant que : hugogogo</p>
|
||
</div>
|
||
<p>On voit qu\'avec l\'argument <strong>important</strong> on retrouve la valeur de la vraie personne connectée</p>
|
||
<p>À noter que cet argument <strong>important</strong> n\'a pas d\'impact utilisé avec l\'autre <strong>id</strong>, ou en dehors du shortcode <strong>custer_author_id</strong>.</p>
|
||
|
||
</details>',
|
||
],
|
||
];
|
||
|
||
const USER_INFO_DATE_FORMAT = 'd/m/Y'; // for user_infos.php (date format : https://www.php.net/manual/fr/datetime.format.php)
|
||
const OPTION_ANCHOR = 'custer_anchor_ids';
|
||
const QUERIES = [
|
||
'__author_page_url__',
|
||
'__user_post_url__',
|
||
'__admin_email__',
|
||
'__base_url__',
|
||
];
|
||
|
||
private static $_backup_current_user = null;
|
||
|
||
|
||
/*
|
||
* setter and getter for current user backup
|
||
*
|
||
*/
|
||
public static function set_current_user_backup() {
|
||
if (self::$_backup_current_user !== null)
|
||
return;
|
||
self::$_backup_current_user = get_current_user_id();
|
||
}
|
||
public static function get_current_user_backup() {
|
||
return self::$_backup_current_user;
|
||
}
|
||
public static function reset_current_user_backup() {
|
||
$backup_user = self::$_backup_current_user;
|
||
if ($backup_user === null) {
|
||
$backup_user = get_current_user_id();
|
||
}
|
||
self::$_backup_current_user = null;
|
||
return $backup_user;
|
||
}
|
||
|
||
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
?>
|