Configurez Redux dans votre thème WordPress

shape
shape
shape
shape
shape
shape
shape
shape

Étape 1: Installation du plugin Redux Framework

Il existe plusieurs façons d’installer Redux Framework dans votre instance, plugin ou thème WordPress. Choisissez le cas qui vous convient le mieux et passez à la deuxième étape.

Installer depuis WordPress.org

En installant Redux en tant que plugin WordPress.org, vous pouvez vous assurer que vos utilisateurs et vous avez toujours la version la plus stable installée. Il vous est suggéré d’utiliser quelque chose comme l’ activation du plugin TGM pour activer le plugin Redux dans votre thème / plugin. Vos utilisateurs l’apprécieront plusieurs fois.

Télécharger depuis WordPress.org

Installer à partir du référentiel Github

Avez-vous besoin d’être à la fine pointe? Ou peut-être qu’il y a un bogue que nous avons récemment corrigé et que vous attendez de voir si cela a fonctionné? Pourrions-nous suggérer d’utiliser le référentiel Github alors. Notre branche principale est conçue pour être notre code le plus stable et le plus à jour. Le saisir vous offrira la meilleure expérience possible. Le déploiement de Redux Framework sur WordPress.org peut être en retard de 3 à 5 jours par rapport à la branche principale. Si vous décidez d’opter pour l’installation de Redux via Github, il existe plusieurs alternatives d’installation.

Méthode Github 1: installation à l’aide de l’archive Zip de GitHub Master Branch

Cette méthode est de loin la plus simple. Installez simplement le contenu du fichier zip en tant que plugin dans votre instance WordPress. C’est la même méthode que l’installation depuis WordPress.org, mais avec le tout dernier code. Vous recevrez toujours les mêmes notifications de mise à jour de WordPress.org. Si vous souhaitez mettre à jour vers une nouvelle version du référentiel Github, vous devrez réinstaller le plugin avec une nouvelle copie.

Méthode Github 2: clonage du référentiel à l’aide de Git

En restant avec les dernières tendances, l’utilisation de Git est recommandée. Il vous permet d’extraire les mises à jour du référentiel à tout moment. En outre, il existe quelques excellents outils d’interface graphique disponibles pour faciliter l’utilisation de Git. Github pour Windows, Github pour Mac ou SourceTree sont recommandés. Ce sont tous de bons utilitaires (et gratuits). Mais de loin, la façon la plus cool d’utiliser Git nécessiterait l’utilisation d’un client git en ligne de commande. Cependant, il y a un peu de courbe d’apprentissage. Si vous n’êtes pas familier avec Git, cette méthode particulière peut être un peu intimidante. Il est suggéré aux débutants de lire Git Immersion . Pour ceux qui souhaitent une compréhension plus approfondie de Git, une autre excellente ressource est Pro Git . Voici comment cloner la branche principale de Redux à partir de la ligne de commande, si vous utilisez Linux / Unix:

REMARQUE : Parce que Linux est la distribution de serveur la plus populaire (et celle que nous recommandons), ces guides sont racontés du point de vue d’un utilisateur Linux. Cela dit, les mêmes commandes s’appliquent généralement à tous les systèmes d’exploitation.

cd my-project git clone https://github.com/ReduxFramework/ReduxFramework.git 

Cela clone le référentiel dans un répertoire intitulé ReduxFramework. Placez ce répertoire dans votre répertoire de plug – in, généralement situé à: ~/wp-content/plugins/. Une fois cette étape terminée, passez à l’étape 2.

Étape 2: initialiser avec un nouveau fichier de configuration

Pour que le nouveau panneau d’options apparaisse, il doit être initialisé. Travailler avec un nouveau système pour la première fois peut être intimidant, nous avons donc inclus un exemple de fichier de configuration décrivant de nombreuses configurations possibles avec Redux. Si vous voulez la façon la plus simple de commencer, c’est une excellente référence. Avant de commencer, il vaut la peine de recommander de ne jamais modifier le fichier sample-config.php lui-même !! La modification directe de ce fichier entraînera une perte de vos données de configuration lors de la mise à jour de la base de code Redux. Au contraire, le fichier sample-config.php doit être copié dans un autre emplacement, où des modifications peuvent alors être apportées. Vous avez été prévenu! Une fois que vous avez copié le fichier sample-config.php vers un nouvel emplacement, ou décidé de jeter toute la prudence au vent et d’utiliser le fichier sample-config.php où il réside actuellement, vous êtes prêt à exiger le fichier de configuration.

REMARQUE : le fichier sample-config.php se trouve dans: ReduxFramework / sample / sample-config.php.
REMARQUE : n’oubliez pas de mettre à jour le chemin pour qu’il corresponde au chemin de votre copie!
REMARQUE : n’oubliez pas de changer le nom de votre classe de configuration ou vous serez en conflit avec d’autres fournisseurs!

require_once (dirname(__FILE__) . '/sample/sample-config.php');

Il ne vous reste plus qu’à vous connecter à votre panneau d’administration. Là, vous devriez voir un menu Options en bas du menu WordPress.

Étape 3: Utilisation des valeurs d’option enregistrées

Le panneau d’options devrait maintenant être ouvert. Il est là, tout beau et soigné, parfait. Alors, comment commencez-vous à utiliser des valeurs enregistrées dans votre thème ou plugin? C’est là que la vraie magie de Redux entre en jeu. Nous comprenons les frustrations liées à l’utilisation d’un nouveau système. C’est pourquoi nous avons fait de notre mieux pour décrire les cas d’utilisation les plus courants afin de simplifier le processus de mise en service de votre nouveau projet!

Pour commencer, vous devrez définir un fichier opt_name. Il s’agit d’un élément clé dans l’utilisation de Redux. Choisissez un nom non seulement descriptif, mais facile à retenir. La opt_namevariable est de savoir comment Redux peut être accédé par plusieurs plugins et thèmes à la fois, sans conflit. Pour les besoins de cet exemple, supposons que la valeur de cette variable est test_theme. Maintenant, pour accéder aux données enregistrées via le panneau de contrôle, il suffit de référencer la valeur de la $test_themevariable globale. Dans sa configuration par défaut, Redux crée automatiquement un tableau des options enregistrées et le définit sur une variable définie par opt_name.

Mais disons que vous ne voulez pas que votre variable soit le opt_name? Redux contient un autre argument définissable intitulé global_variable. Lorsqu’il est défini, cet argument remplace le nom par défaut utilisé lors de la création de la variable globale.

REMARQUE : pour désactiver la création de la variable globale, définissez global_variablesur false. Mais avec une fonctionnalité aussi intéressante, pourquoi le voudriez-vous?

Cette variable peut être utilisée sans rien d’autre dans votre functions.phpfichier et d’autres fichiers, à condition que votre code ne soit pas dans une autre fonction. Si tel est le cas, la variable doit être définie comme globale pour la fonction. C’est une limitation PHP ennuyeuse. Vous trouverez ci-dessous un exemple de la manière d’y parvenir. En bref, il est nécessaire d’utiliser global $test_theme;dans la fonction avant d’essayer d’utiliser la variable.

Étant donné que les fichiers de modèle WordPress (en-tête, pied de page, archive, etc.) sont exécutés dans une fonction, la variable devra être massée, comme mentionné précédemment. Voici un exemple complet de ce qui doit être fait dans une fonction pour obtenir les valeurs d’option.

// Due to a limitations of variables and functions, you must globally define
// variables inside functions.
global $redux_demo  // This is your opt_name.
print_r ($redux_demo);

Voilà. C’est tout!

Vous pouvez maintenant commencer à utiliser Redux dans votre propre thème ou plugin. Nous espérons sincèrement que vous l’aimerez autant que nous avons aimé vous l’apporter.

Vous voulez une intégration plus approfondie?

Si vous avez besoin d’intégrer Redux dans votre thème / plugin, veuillez lire la page Apprenez à intégrer Redux dans votre thème / plugin pour en savoir plus!

Source: Redux

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *