filtre Ajax catégories d'hébergement wordpress
introduction
Cet article, qui vise les développeurs plugin, décrit comment ajouter Ajax à un plug-in. Avant de lire cet article, vous devez être familier avec les éléments suivants:
- Ajax - Présentation de la technologie
- Rédaction d'un plug-in - Comment écrire un plug-in
- Plugin API - Filtres et actions - ce qu'ils sont et comment les utiliser
- Comment ajouter du code HTML à la page de WordPress appropriée, après, ou à l'écran - si vous voulez ajouter Ajax aux écrans d'administration que vous créez, vous aurez besoin de comprendre comment ajouter des menus d'administration à WordPress par exemple,; si vous voulez ajouter Ajax à l'affichage d'un seul poste, vous aurez besoin de comprendre les filtres à droite et des actions pour ajouter du code HTML à cet endroit sur les écrans de blog téléspectateurs face. Cet article ne couvre pas ces sujets.
Ajax sur le côté administration
Depuis l'Ajax est déjà intégré dans les écrans d'administration WordPress de base, en ajoutant l'administration côté Ajax fonctionnalité à votre plug-in est assez simple.
Cet exemple court utilise PHP pour écrire notre JavaScript dans le bas de la page. Ce script déclenche alors la requête AJAX lorsque la page est complètement chargée:
NOTE: Depuis la version 2.8. La ajaxurl variable globale JavaScript peut être utilisé dans le cas où vous souhaitez séparer votre code JavaScript à partir de fichiers php dans JavaScript uniquement les fichiers. Cela est vrai du côté de l'administration seulement. Si vous utilisez AJAX sur le front-end, vous devez rendre votre JavaScript conscient de l'url admin-ajax.php. Une bonne pratique est documentée dans le quatrième exemple, ci-dessous à l'aide wp_localize_script ().
Ensuite, mettre en place une fonction PHP pour gérer la requête AJAX.
Remarquez comment la « action » de valeur clé « de my_action », défini dans notre JavaScript ci-dessus, correspond à la seconde moitié de l'action « wp_ajax_my_action » dans notre gestionnaire AJAX ci-dessous. En effet, il est utilisé pour appeler le côté serveur fonction PHP par admin-ajax.php. Si une action n'est pas spécifié, admin-ajax.php quittera, et revenir 0 dans le processus.
Vous devez ajouter quelques détails, comme la vérification des erreurs et de vérifier que la demande est venue du bon endroit (à l'aide check_ajax_referer ()), mais nous espérons que l'exemple ci-dessus sera suffisant pour vous aider à démarrer votre propre administration côté plug-in Ajax .
Notez l'utilisation de wp_die (). au lieu de die () ou de sortie (). La plupart du temps, vous devriez utiliser wp_die () dans votre fonction de rappel Ajax. Cela permet une meilleure intégration avec WordPress et le rend plus facile de tester votre code.
Fichier JavaScript distinct
Le même exemple que le précédent, sauf avec le JavaScript sur un fichier externe indépendant nous appellerons js / my_query.js. Les exemples sont liés à un dossier de plug-in.
Avec des fichiers JavaScript externes, il faut d'abord wp_enqueue_script () afin qu'ils figurent sur la page. De plus, nous devons utiliser wp_localize_script () pour transmettre des valeurs dans les propriétés des objets JavaScript, PHP ne peut pas car les valeurs d'écho directement dans notre fichier JavaScript. La fonction de gestion est le même que l'exemple précédent.
Ajax sur le côté Viewer-face
Depuis WordPress 2.8, il y a un crochet similaire à wp_ajax_ (action).
Donc, si vous voulez tirer sur le front-end pour les visiteurs et les utilisateurs connectés, vous pouvez le faire:
Remarque: A la différence du côté admin, le javascript global ajaxurl ne soit pas défini automatiquement pour vous, sauf si vous avez un autre plugin BuddyPress ou Ajax-dépendants installé. Ainsi, au lieu de se fier à une variable globale javascript, déclarer un objet espace de noms javascript avec sa propre propriété, ajaxurl. Vous pouvez également utiliser wp_localize_script () pour rendre l'URL disponible à votre script, et de générer à l'aide de cette expression: admin_url ( « admin-ajax.php »)
Note 2: Les deux front-end et back-end demandes Ajax utiliser renverra toujours vrai si is_admin () admin-ajax.php dans votre code de gestion action. Lors du chargement de manière sélective vos gestionnaires de script Ajax pour le front-end et back-end, et en utilisant la fonction is_admin (), votre crochets wp_ajax_ (action) et wp_ajax_nopriv_ (action) doivent être insérés dans la is_admin () === partie vraie.
les requêtes Ajax liés à des actions soit wp_ajax_ ou wp_ajax_nopriv_ sont exécutées dans le contexte WP Administrateur. Examinez attentivement les actions que vous effectuez dans votre code puisque les utilisateurs non privilégiés ou les visiteurs seront en mesure de déclencher des demandes avec des autorisations élevées qu'elles ne peuvent pas être autorisés pour.
Ici, le my_frontend_action d'action Ajax déclenche la fonction PHP my_frontend_action_callback () pour tous les utilisateurs. Le my_backend_action d'action Ajax déclenche la fonction PHP my_backend_action_callback () pour les utilisateurs connectés seulement.
Le JavaScript post-charge de l'événement
Plugins et thèmes insérer du contenu via Ajax doit déclencher l'événement post-charge sur document.body est inséré après le contenu. D'autres scripts qui dépendent d'une interaction JavaScript après l'insertion de contenu, tels que AddToAny ou un script de maçonnerie jQuery, écoutez l'événement post-charge pour initialiser leur JavaScript requis. Lorsque l'événement post-charge est tiré de Parchemin infini Jetpack. par exemple, AddToAny affiche les boutons de partage pour chaque poste, et jQuery Maçonnerie positionne les éléments sur la page.
JavaScript déclenche l'événement post-charge après que le contenu a été inséré via Ajax:
JavaScript écoutant l'événement post-charge:
Note sur jQuery: Méfiez-vous d'utiliser la méthode de charge de jQuery avec une expression de sélection d'insérer du contenu, car il provoquera
