Guide du débutant sur le framework Titan Créer une Metabox avec Titan

Titan Framework a vraiment facilité la tâche fastidieuse de création de métaboxes dans votre projet de développement Web. Avant Titan Framework, je devais écrire un très long morceau de code pour afficher des métaboxes dans les écrans d'édition de publication et / ou de page. Maintenant, le processus est vraiment facile, et c'est ce dont je vais discuter aujourd'hui. Alors, apprenons à créer un metabox avec Titan Framework.

Créer un Metabox dans Titan

Avant de plonger dans ce sujet, supposons que vous ayez:

• un site de démonstration fonctionnant avec WordPress installé 
• Titan Framework plugin installé et activé ou intégré dans ce site de démonstration 
• la titan-framework-checker.php fichier inclus dans votre projet

Encore une fois, je fais référence à mon thème appelé Neat pour le code que je vais utiliser ici. Dans des articles précédents, j’ai expliqué que les fichiers de modèles du thème étaient organisés de telle sorte qu’il existe un dossier séparé pour les éléments liés à l’administrateur à l’intérieur du répertoire. les atouts dossier. Cette plus contient un fichier pour le code de metaboxes, à savoir. metabox-options-init.php, qui se trouve ici: actifs / admin /titanframework/metabox-options-init.php.

Donc, voici le code qui ajoutera une metabox sur les écrans d'édition de tous les types de publication que nous avons mentionnés, à savoir:

• page
• poster
• my_custom_post_type, qui est censé être le nom de tout type de message personnalisé
  

createMetaBox (array ('name' => 'Options Metabox', // Nommez le menu des options. 'post_type' => array ('page', 'post', 'my_custom_post_type') // Peut être une chaîne ou un tableau.) ) 

Au tout début, quelques lignes commentées vous fournissent certains des liens d’aide que vous pouvez entretenir en ce qui concerne le développement de métaboxes. Ci-dessous est un add_action () fonction qui prend la tf_create_options crochet qui enregistre le aa_metabox_options fonction pour ajouter des options à l'intérieur de la metabox.

Next (ligne 14), j'ai défini une fonction pour envelopper notre code metabox, c'est-à-dire. aa_metabox_options. Ceci contient toute la fonctionnalité nécessaire pour créer notre metabox. 

Le processus commence par obtenir une instance unique de Titan Framework et l’enregistrer dans le répertoire $ titan variable (à la ligne 17). Appeler le getInstance () La fonction fait partie intégrante de Titan et est nécessaire dans chaque nouvelle routine ou fichier dans lequel vous utilisez Titan Framework. Cette fonction comporte un paramètre unique, idéalement votre nom de thème pour initialiser Titan dans votre projet. C'est pourquoi j'ai utilisé 'soigné' comme mon nom unique. Je l'ai expliqué en détail dans un article précédent aussi.

La ligne 23 de ce code est l'endroit où j'ai créé la metabox. Avec Titan Framework, vous pouvez utiliser le createMetaBox () fonction pour ajouter des métaboxes dans vos thèmes / plugins. Donc, selon cette ligne de code, je crée un $ aa_metbox metabox dans Titan Framework.

Notez une autre chose: le createMetaBox () fonction obtient un tableau de paramètres qui peuvent prendre des paramètres tels que prénom, desc, Type de poste, etc. Ainsi, en utilisant ceux-ci, j'ai nommé cette metabox 'Options Metabox'(ligne 24). Par conséquent, il apparaîtra avec ce nom dans ma page et l'écran de post-édition.

La dernière ligne (ligne 25) de ce code attache ce metabox nouvellement créé à tous les types de post que je mentionne. Type de poste est à nouveau un paramètre qui spécifie dans quel type de publication cette métabox sera affichée. Dans le cas de mon code, je l’affiche sur toutes les pages et tous les articles, et my_custom_post_type. Notez également que ce paramètre occupe un tableau si vous devez utiliser la métabox sur plusieurs types de publication. Mais il peut également s'agir d'une chaîne lorsque vous devez utiliser la metabox uniquement pour un type de publication, par exemple. 'post_type' => 'page'.

Maintenant, allez à votre tableau de bord WordPress et cliquez sur Ajouter un nouveau menu dans Des postes. Faites défiler la liste et vous trouverez une metabox nommée Options Metabox. Voici la capture d'écran pour cela:

Faites la même chose pour n’importe quelle page ou type de publication personnalisé de votre site Web, et vous y trouverez le même métabox..

Cette metabox est vide pour le moment. Alors ajoutons-y des options.

Ajout d'options à l'intérieur d'un Metabox

Il suffit de copier et coller ces lignes juste en dessous du code écrit ci-dessus.  

createOption (array ('id' => 'aa_mb_txt', // L'identifiant qui sera utilisé pour obtenir la valeur de cette option. 'type' => 'text', // Type d'option que nous créons. 'nom' => 'Mon option de texte', // Nom de l'option qui sera affichée dans le panneau d'administration. 'Desc' => 'Ceci est notre option' // Description de l'option qui sera affichée dans le panneau d'administration.) ) 

Créer des options dans Titan n'est pas quelque chose de nouveau pour vous. J'ai encore une fois utilisé le createOption () fonction pour ajouter des options. Mais ce que vous devriez noter est la ligne 9, qui spécifie également où créer cette option, c.-à-d. $ aa_metbox. Donc, j'ai créé un texte champ de type à l'intérieur de la metabox nommée 'Mon option de texte'dont l'identifiant est aa_mb_txt. 

La capture d'écran ci-dessus est le résultat de mon développement jusqu'à présent. Mais cette fois, il s'agit d'une page. Vous pouvez clairement trouver le Options Metabox boîte qui a un Mon option de texte champ dedans.

Alors, que reste-t-il? Imprimer la sortie sur le front-end après avoir récupéré la valeur. Faisons-le maintenant!

Obtenir les valeurs sauvegardées

Maintenant, je vais récupérer les valeurs enregistrées au front-end pour la page dans la capture d'écran ci-dessus. Voici:

getOption ('aa_mb_txt', get_the_ID ()); / ** * Première option metabox. * / // Utilisons cette valeur en HTML. ?> 
La valeur de l'option metabox txt pour cette page est: 

Ici le getOption () La fonction (ligne 10) porte deux paramètres. L’un est l’identifiant unique de l’option, c’est-à-dire. aa_mb_txt, et le second est le get_the_ID_ () une fonction. J'ai utilisé get_the_ID () car la metabox a été créée pour tous les types de publication que nous avons définis. Si vous avez besoin d’obtenir la valeur d’une option metabox pour une page / une publication spécifique, getOptions () fonctionne l'ID de cet article / page spécifique. Le résultat est enregistré dans $ aa_mb_txt_val.

Ensuite, un paragraphe est créé (ligne 19) dans lequel j'ai utilisé le écho commande pour imprimer le résultat via aa_mb_txt_val. 

Supposons que je suis entré Option texte AA dans le metabox et publié la page.

Et voila, tout fonctionne comme un charme.

Conclusion

Vous savez maintenant comment créer des méta-boîtes avec Titan Framework. Vous réalisez à quel point c'est simple. Dans les prochains articles de cette série, j'écrirai comment créer un type d'option particulier avec Titan Framework dans une boîte méta. J'assumerai le fait que vous savez déjà comment créer la méta-boîte elle-même. Donc, il est essentiel pour vous d'essayer cela.

Dans le prochain article, je créerai des sections et des panneaux de personnalisation de thème avec des options. Comment est-ce cool? D'ici là, si vous avez des questions, n'hésitez pas à me contacter via des commentaires ou à me contacter sur Twitter..