Deoarece aceasta este prima mea experiență de traducere a textelor tehnice mari, sunt disponibile bloopers. Orice corecție va fi acceptată cu bucurie;)
Traducerea sub tăiere.
Scrierea unui plugin
Până la versiunea WordPress 1.2, dacă doriți să schimbați comportamentul, a trebuit să modificați (sau "hack") codul sursă al WordPress. Cu toate acestea, în majoritatea versiunilor curente ale WordPress, puteți să modificați cu ușurință funcționalitatea kernelului WordPress sau să adăugați unul nou folosind pluginurile. Ideea de bază a utilizării unei arhitecturi extensibile este menținerea kernelului relativ simplu, dar suficient de flexibil, fiecare aspect al intrării și ieșirii acestuia putând fi schimbat cu plug-in-uri. Iată definiția:
WordPress plug-in - este un program sau un set de funcții scrise în PHP, care adaugă un anumit set de caracteristici sau servicii la un blog pe WordPress, care pot fi ușor combinate cu controlul și metodele de utilizare a sistemului WordPress Plugin Application Program Interface (API).
Plugin Resources - o listă cuprinzătoare de articole și instrumente pentru dezvoltatorii plug-in, care include articole detaliate despre scrierea plug-in-urilor și articole despre anumite subiecte "înguste".
O altă modalitate bună de a învăța pluginurile dispozitivului este să te uiți la codul sursă PHP al plug-in-urilor bine scrise, cum ar fi Hello Dolly. plug-in, care este inclus în oferta de bază a WordPress.
Dacă ați scris un plugin pentru WordPress, citiți Plugin Submission and Promotion. Pentru a afla cum să distribuiți plugin-ul.
Crearea unui plugin
Această parte a articolului vă va informa ce pași trebuie să faceți pentru a crea un plug-in bun.
Numele, fișierele și locațiile fișierelor
Numele pluginului
Prima sarcină atunci când creați un plug-in este să vă gândiți ce va face plug-in-ul și să veniți cu un nume pentru el (de preferință unic). Verificați pluginurile și alte depozite pentru a vă asigura că numele pe care l-ați inventat este unic; puteți, de asemenea, să vă numiți numele Google. Majoritatea dezvoltatorilor plug-in aleg nume care reflectă funcționalitatea plug-in-ului; De exemplu, pluginul pentru afișarea timpului poate avea cuvântul "vreme" în titlu. Numele poate conține mai multe cuvinte. (Firește, pluginul dvs. ar trebui să aibă un nume în limba engleză.)
Fișierele Plugin
Următorul pas este să creați un fișier PHP cu un nume derivat din numele pluginului. De exemplu, dacă pluginul dvs. este numit Funcționalitate fabuloasă, puteți numi fișierul fabfunc.php. Din nou, încercați să creați un nume unic. Persoanele care instalează plugin-ul dvs. vor pune acest fișier în directorul lor pentru wp-content / plugins / plugins și două plug-in-uri pe care o persoană le utilizează pot avea același nume de fișier.
În acest articol, "fișierul plug-in PHP" înseamnă fișierul principal PHP, care se află în directorul pentru plug-in-uri sau subdirectorul acestuia.
Fișierul "Citiți-mă" (citiți-mă)
Pagina principală
De asemenea, este foarte convenabil să creați o pagină web care să acționeze ca "pagina de pornire" a plug-in-ului dvs. Această pagină ar trebui să explice cum să instalați plug-in-ul, ce face, ce versiuni de WordPress sunt compatibile, ce se schimbă de la o versiune la o versiune a plug-in-ului dvs. și cum se utilizează plug-in-ul.
Anteturi de fișiere
Este timpul să oferiți câteva informații despre fișierul dvs. principal PHP.
Informații standard despre plugin
Începutul fișierului dvs. trebuie să conțină un antet de informații standard. Acest antet permite WordPress să înțeleagă că există plugin-ul dvs., să îl adăugați la panoul de control al plug-in-urilor în cazul în care acesta poate fi activat, să-l încărcați și să-i executați funcțiile; fără un titlu, plugin-ul dvs. nu va fi niciodată activat și rulat. Acesta este formatul antetului:
(bineînțeles, totul ar trebui să fie în limba engleză - nota unui interpret)
Informațiile minime pe care WordPress trebuie să le găsească este numele lor (numele de plugin). Restul informațiilor (dacă există) sunt folosite pentru a crea un tabel plug-in pe pagina de gestionare a pluginurilor. Ordinea liniilor nu este importantă.
Antetul standard urmează, de obicei, informațiile despre licență pentru plug-in. Majoritatea pluginurilor utilizează o licență GPL sau o licență compatibilă cu GPL. Pentru a specifica licența GPL, adăugați următoarele fișiere în fișierul pluginului:
Programarea pluginului
Este timpul să forțați plug-in-ul să facă ceva. Această parte a articolului conține mai multe idei de bază pentru dezvoltarea de plug-in-uri și explică modul de a aduce la perfecțiune mai multe sarcini pe care plug-in-ul dvs. le va face.
Plug-in "Hooks"
Multe pluginuri își îndeplinesc sarcinile prin conectarea la una sau mai multe "capcane". "Capcane" funcționează în timp ce rulează WordPress. WordPress verifică dacă mai multe pluginuri au aceleași funcții înregistrate și dacă da, funcțiile sunt pornite. Aceste funcții schimbă comportamentul standard al WordPress.
De exemplu, înainte de a adăuga WordPress post-antet în concluzie browser-ului, se verifică mai întâi dacă o funcție înregistrată plug pentru „sita“ intitulat „the_title“. În caz contrar, textul antetului este trecut prin fiecare funcție înregistrată și rezultatul final este ieșit. Astfel, în cazul în care dvs. de plugin trebuie să adăugați câteva informații la titlul postului, el poate înregistra un filtru funcție «the_title».
Un alt exemplu este o "capcană activă" numită "wp_footer". Înainte de sfârșitul paginii HTML pe care WordPress o generează, verifică dacă orice plug-inuri au o funcție "wp_footer" înregistrată și o lansează.
Puteți afla mai multe despre cum să înregistrați funcțiile pentru filtre și "capcane" și care "capcane" sunt disponibile în WordPress, în API-ul Plugin. Dacă găsiți un loc în codul WordPress unde doriți să aveți o acțiune sau un filtru, dar în WordPress nu există, puteți oferi noi "capcane" (sugestiile sunt acceptate în mare parte); cum se face, puteți afla în Raportarea bug-urilor.
Etichete de șablon
Un alt mod de a adăuga funcționalitate cu plugin-ul este de a crea etichete de șablon. Oricine dorește să utilizeze plugin-ul poate adăuga aceste etichete în tema în panoul, în secțiunea de conținut poștă sau la alt loc similar. De exemplu, un plugin care adaugă geoetichete la posturi pot fi definite funcție de șablonul pe etichete cu numele geotag_list_states () din panou, care este o listă cu toate posturile tagged-geo-tag, cu referire la arhiva de pagini plugin.
Pentru a declara o etichetă șablon, trebuie doar să scrieți funcția php și să o documentați pentru utilizatorii plugin-ului pe pagina dvs. de plug-in și / sau în fișierul principal de plugin. O idee bună atunci când documentați o funcție este de a da un exemplu de execuție care conține