Γράφοντας μια απλή προσθήκη WordPress, Tutorial για αρχάριους

Στην απλή γλώσσα, ένα plugin WordPress είναι ένα απλό πρόγραμμα που σας βοηθά να προσαρμόσετε και να βελτιώσετε τον ιστότοπό σας WordPress χωρίς να χρειάζεται να επεξεργαστείτε τον βασικό προγραμματισμό. Όταν κυριαρχήσετε Ανάπτυξη προσθηκών WordPress, θα είστε σε θέση να προσθέσετε κάθε είδους λειτουργικότητα στο WordPress blog σας σε χρόνο μηδέν. Αλλά πριν γίνετε επαγγελματίας, πρέπει να μάθετε τα σχοινιά.


Ένα WordPress Plugin είναι ένα πρόγραμμα ή ένα σύνολο από μία ή περισσότερες λειτουργίες, γραμμένες στη γλώσσα δέσμης ενεργειών PHP, που προσθέτει ένα συγκεκριμένο σύνολο δυνατοτήτων ή υπηρεσιών στο ιστολόγιο WordPress, το οποίο μπορεί να ενσωματωθεί απρόσκοπτα στο ιστολόγιο χρησιμοποιώντας σημεία πρόσβασης και μεθόδους παρέχεται από τη διασύνδεση προγράμματος εφαρμογής Plugin WordPress (API). – Γράφοντας ένα πρόσθετο, WordPress Codex

Στη σημερινή ανάρτηση, θα σας καθοδηγήσουμε στη διαδικασία δημιουργίας της πρώτης προσθήκης WordPress. Θα διατηρήσουμε το σεμινάριο απλό για να καλύψουμε τον προγραμματιστή για πρώτη φορά που δεν έχει καθόλου γνώσεις PHP (η γλώσσα scripting πίσω από το WordPress).

Πριν φτάσουμε στην πραγματική κωδικοποίηση, ωστόσο, θα εξετάσουμε μερικά πράγματα που πρέπει να καταλάβετε σχετικά με την ανάπτυξη plugin του WordPress.

Βασικά στοιχεία που πρέπει να γνωρίζετε πριν από τη δημιουργία μιας προσθήκης WordPress

Σε αυτήν την ενότητα, θα αποκαλύψουμε το πρώτα βήματα πρέπει να ακολουθήσετε κατά τη δημιουργία μιας προσθήκης WordPress. Επιπλέον, θα αναφέρουμε όλα τα διάφορα πράγματα που πρέπει να λάβετε υπόψη κατά τη σύνταξη της προσθήκης σας. Εξαιρετική. Ας ξεκινήσουμε με τα βασικά.

Πώς να ονομάσετε μια προσθήκη WordPress

Πριν από οτιδήποτε άλλο, πρέπει να βρείτε ένα μοναδικό όνομα για την προσθήκη WordPress. Ένας από τους καλύτερους τρόπους για να προσδιορίσετε ένα ευνοϊκό όνομα είναι να σκεφτείτε τι θα κάνει η προσθήκη σας. Έτσι, για παράδειγμα, εάν η προσθήκη σας θα βοηθήσει τους χρήστες να μοιράζονται περιεχόμενο μέσω κοινωνικών μέσων, μπορείτε να συμπεριλάβετε τη φράση “κοινή χρήση κοινωνικών μέσων” στο όνομα. Ένα άλλο πράγμα, τα ονόματα των προσθηκών μπορεί να είναι αρκετές λέξεις, οπότε μην περιορίζετε τη δημιουργικότητα.

Το όνομα της προσθήκης σας πρέπει να είναι μοναδικό για την αποφυγή διενέξεων με άλλα πρόσθετα. Για να βεβαιωθείτε ότι το όνομά σας είναι μοναδικό, μπορείτε να κάνετε μια αναζήτηση Google στο όνομα. Επιπλέον, μπορείτε να κάνετε αναζήτηση στους διάφορους καταλόγους προσθηκών, συμπεριλαμβανομένου του Αποθήκη προσθηκών WordPress.

Για να ονομάσουμε οποιοδήποτε πρόσθετο, πρέπει να δημιουργήσουμε τουλάχιστον ένα αρχείο προσθήκης (το κύριο αρχείο PHP), το οποίο μας εισάγει στην επόμενη ενότητα μας.

Πώς να δημιουργήσετε αρχεία προσθηκών

Ένα πρόσθετο μπορεί να αποτελείται από ένα μόνο αρχείο PHP ή πολλά αρχεία ανάλογα με το τι έχει σχεδιαστεί να κάνει. Το πιο σημαντικό αρχείο είναι το κύριο Αρχείο PHP, που είναι το αντίστοιχο του index.php και του index.html σε θέματα WordPress και σχέδια HTML αντίστοιχα.

Συνιστάται στους προγραμματιστές του WordPress να ονομάσουν το κύριο αρχείο προσθηκών τους μετά την προσθήκη τους κατά σύμβαση. Για παράδειγμα, το κύριο αρχείο προσθήκης για ένα πρόσθετο που ονομάζεται WP Renym plugin θα είναι wp-renym.php. Εάν προσθέτετε ένα διαχωριστικό στο όνομά σας, χρησιμοποιήστε μόνο ενωτικά (-) μεταξύ των λέξεων σε αντίθεση με τα κάτω παύλα (_).

Όπως αναφέρθηκε παραπάνω, ένα πρόσθετο μπορεί να δημιουργηθεί από ένα ή περισσότερα αρχεία (εικόνες, JavaScript, γλώσσα, αρχεία CSS κ.λπ.). Σε κάθε περίπτωση, τα αρχεία προσθηκών σας πρέπει να βρίσκονται σε έναν μόνο κατάλογο. Έτσι για ένα πρόσθετο που ονομάζεται WP Renym the wp-renym.php το αρχείο θα τοποθετηθεί σε ένα wp-renym ντοσιέ. Πρόσθετοι δευτερεύοντες φάκελοι μπορούν να προστεθούν μέσα στον κύριο φάκελο πρόσθετων για να περιέχουν και να οργανώνουν άλλα αρχεία.

Αφού καθορίσετε όλο τον κώδικα για ένα πρόσθετο, στη συνέχεια συμπιέζετε τον κύριο φάκελό σας σε ένα αρχείο zip (σε αυτήν την περίπτωση θα ήταν αρχείο wp-renym.zip) να μεταφορτωθεί και να εγκατασταθεί σε ιστότοπο WordPress.

Προσθήκη κεφαλίδας αρχείου στο κύριο αρχείο PHP

Κατά την ονομασία της προσθήκης σας θα πρέπει να προσθέσετε άλλες λεπτομέρειες, όπως περιγραφή, έκδοση, άδεια, όνομα συντάκτη – βασικά όλα όσα θα εμφανίζονται κάτω και δίπλα στην προσθήκη σας στο Οθόνη προσθηκών WordPress – η κεφαλίδα της προσθήκης. Για αυτό πρέπει να χρησιμοποιήσετε ένα τυπική κεφαλίδα πληροφοριών προσθήκης στην κορυφή του κύριου αρχείου PHP. Έτσι φαίνεται μια τυπική κεφαλίδα:


/ *
Όνομα προσθήκης: Όνομα της προσθήκης σας
URI προσθήκης: σύνδεσμος http: // στην αρχική σελίδα της προσθήκης σας
Περιγραφή: Περιγράψτε ποια είναι η προσθήκη σας σε μερικές σύντομες προτάσεις
Έκδοση: 1.0
Συγγραφέας: Το όνομά σας (Yay! Εδώ έρχεται φήμη ...)
Συντάκτης URI: σύνδεσμος http: // στον ιστότοπό σας
Άδεια: GPL2 κ.λπ.
URI άδειας: http: // σύνδεσμος για την άδεια προσθήκης
* /

Κάθε παράμετρος στην παραπάνω κεφαλίδα είναι αυτονόητη, επομένως δεν θα αναφερθώ στις λεπτομέρειες. Απλώς βεβαιωθείτε ότι συμπεριλαμβάνετε τα σχετικά http: // ή https: // όταν γράφετε URI Plugin και Author ή οι σύνδεσμοι δεν θα λειτουργούν.

Ακολουθήστε την κεφαλίδα σας με τις ακόλουθες πληροφορίες άδειας χρήσης εάν θα χρησιμοποιήσετε το Άδεια GPL2 ή μια άδεια συμβατό με το GPL2:

/ * Πνευματικά δικαιώματα YEAR PLUGIN_AUTHOR_NAME (email: η διεύθυνση email σας)
(Plugin Name) είναι δωρεάν λογισμικό: μπορείτε να το αναδιανείμετε ή / και να το τροποποιήσετε
σύμφωνα με τους όρους της GNU General Public License όπως δημοσιεύθηκε από το
το Ίδρυμα Ελεύθερου Λογισμικού, είτε την έκδοση 2 της Άδειας, είτε
οποιαδήποτε μεταγενέστερη έκδοση.

(Plugin Name) διανέμεται με την ελπίδα ότι θα είναι χρήσιμο,
αλλά ΧΩΡΙΣ ΕΓΓΥΗΣΗ χωρίς καν τη σιωπηρή εγγύηση της
ΕΜΠΟΡΙΚΟΤΗΤΑ ή ΚΑΤΑΛΛΗΛΟΤΗΤΑ ΓΙΑ ΕΙΔΙΚΟ ΣΚΟΠΟ. Δείτε το
GNU General Public License για περισσότερες λεπτομέρειες.

Θα έπρεπε να έχετε λάβει αντίγραφο της άδειας GNU General Public License
μαζί με (Όνομα προσθήκης). Εάν όχι, ανατρέξτε στον σύνδεσμο (http: // με την άδεια προσθήκης).
* /

Το πεδίο αυτού του σεμιναρίου δεν μας επιτρέπει να προχωρήσουμε πέρα ​​από αυτά τα βασικά βήματα. Θα πρέπει να δείτε το γράφοντας ένα πρόσθετο οδηγός στον κώδικα για να μάθετε περισσότερα σχετικά με τα άγκιστρα προσθηκών WordPress, τις ετικέτες προτύπων, την αποθήκευση δεδομένων προσθηκών σε βάσεις δεδομένων, τον μηχανισμό επιλογών προσθηκών και την ενημέρωση της προσθήκης σας, μεταξύ άλλων. Ο κωδικός περιλαμβάνει επίσης ένα τεράστιο Πόροι προσθηκών συλλογή που είναι γεμάτη οδηγούς βίντεο, προηγμένα θέματα και άλλα.

Τώρα που έχουμε καλύψει τα βασικά, ας γράψουμε μια απλή προσθήκη WordPress που θα εκτελεί δύο βασικές (αλλά ωραίες) λειτουργίες:

  • Αντικαταστήστε τις λέξεις στο περιεχόμενό σας με τη δική σας επιλογή λέξεων
  • Προσθέστε μια σημείωση “Ευχαριστώ που διαβάσατε αυτό το σεμινάριο …” στο τέλος κάθε ανάρτησης ιστολογίου.

Πώς να γράψετε μια απλή προσθήκη WordPress – WP Renym

Σε αυτήν την ενότητα, θα γράψουμε κώδικα για την προσθήκη WP Renym που ανέφερα.

Ο, τι χρειάζεσαι:

  • Ο αγαπημένος σας επεξεργαστής κώδικα (π.χ.. Μπλοκ ΣΗΜΕΙΩΣΕΩΝ++ & SublimeText)
  • Ένα πρόγραμμα περιήγησης για να δείτε την προσθήκη σας στην εργασία (π.χ.. Χρώμιο)
  • Μια εργασία WordPress εγκατάσταση

Ονομασία της προσθήκης μας

Αρχικά, ελέγξαμε το αποθετήριο WordPress plugin και κάναμε μια αναζήτηση Google στο όνομά μας. Το WP Renym ήταν δωρεάν. Η αρχική μου επιλογή ήταν το WP Rename αλλά είχε ήδη ληφθεί.

Προχωρώντας… Ανοίξτε ένα νέο αρχείο στον επεξεργαστή κώδικα και προσθέστε τον ακόλουθο κώδικα στην κορυφή μετά το άνοιγμα της προσθήκης :

/ *
Όνομα προσθήκης: WP Renym
URI προσθήκης: σύνδεσμος http: // στην αρχική σελίδα της προσθήκης σας
Περιγραφή: Αυτό το πρόσθετο αντικαθιστά τις λέξεις με τη δική σας επιλογή λέξεων.
Έκδοση: 1.0
Συγγραφέας: Freddy Muriuki
Συντάκτης URI: σύνδεσμος http: // στον ιστότοπό σας
Άδεια: GPL2 κ.λπ.
URI άδειας: https: // σύνδεσμος προς την άδεια προσθήκης

Πνευματικά δικαιώματα YEAR PLUGIN_AUTHOR_NAME (email: η διεύθυνση email σας)
(Plugin Name) είναι δωρεάν λογισμικό: μπορείτε να το αναδιανείμετε ή / και να το τροποποιήσετε
σύμφωνα με τους όρους της GNU General Public License όπως δημοσιεύθηκε από το
το Ίδρυμα Ελεύθερου Λογισμικού, είτε την έκδοση 2 της Άδειας, είτε
οποιαδήποτε μεταγενέστερη έκδοση.

(Plugin Name) διανέμεται με την ελπίδα ότι θα είναι χρήσιμο,
αλλά ΧΩΡΙΣ ΕΓΓΥΗΣΗ χωρίς καν τη σιωπηρή εγγύηση της
ΕΜΠΟΡΙΚΟΤΗΤΑ ή ΚΑΤΑΛΛΗΛΟΤΗΤΑ ΓΙΑ ΕΙΔΙΚΟ ΣΚΟΠΟ. Δείτε το
GNU General Public License για περισσότερες λεπτομέρειες.

Θα έπρεπε να έχετε λάβει αντίγραφο της άδειας GNU General Public License
μαζί με (Όνομα προσθήκης). Εάν όχι, ανατρέξτε στον σύνδεσμο (http: // με την άδεια προσθήκης).
* /

Αποθηκεύστε το αρχείο ως wp-renym.php στο φάκελο wp-renym. Εάν δεν έχετε ήδη το φάκελο, δημιουργήστε τον. wp-renym.php θα είναι το κύριο αρχείο PHP.

Προσθήκη λειτουργιών

Τώρα για να προσθέσετε τις πραγματικές λειτουργίες στην προσθήκη. Ακριβώς κάτω από τον παραπάνω κώδικα, προσθέστε την ακόλουθη συνάρτηση για να διορθώσετε τα ορθογραφικά λάθη του wordpress προς την WordPress:

συνάρτηση renym_wordpress_typo_fix ($ text) {
επιστροφή str_replace ('wordpress', 'WordPress', $ text);
}
add_filter ('the_content', 'renym_wordpress_typo_fix');

renym_wordpress_typo_fix είναι το μοναδικό όνομα που έχουμε δώσει τη λειτουργία μας. Όταν προσθέτετε νέες λειτουργίες, μην τις ξεκινάτε ποτέ wp_ – αυτό για να αποφευχθούν τυχόν μελλοντικές ασυμβατότητες με λειτουργίες κώδικα WordPress που χρησιμοποιούν όλοι το πρόθεμα wp_.

Η συνάρτηση PHP μας παίρνει (κείμενο $) ως όρισμα και επιστρέφει την πρώτη συμβολοσειρά «wordpress» που αντικαταστάθηκε με τη δεύτερη συμβολοσειρά «WordPress».

Προσθέσαμε ένα φίλτρο (add_filter) στην προσθήκη μας για να πούμε τη λειτουργία μας ( renym_wordpress_typo_fix ) για να επεξεργαστούμε το κείμενο που επιλέξαμε, το οποίο σε αυτήν την περίπτωση είναι ολόκληρο το περιεχόμενο ανάρτησης (το__ περιεχόμενο).

Για να αντικαταστήσετε περισσότερες από μία λέξεις (ίσως θέλετε να επεξεργαστείτε πολλές λέξεις στο ιστολόγιό σας ή να χρησιμοποιήσετε την προσθήκη ως απλό φίλτρο βωμολοχίας), αντικαταστήστε τον παραπάνω κώδικα με τον ακόλουθο κώδικα:

function renym_content_replace (περιεχόμενο $) {
$ search = array ("wordpress", "κατσίκα", "Πάσχα", "70", "εντυπωσιακό");
$ Repl = array ("WordPress", "καφές", "Πάσχα διακοπές", "εβδομήντα", "εξαιρετικό");
επιστροφή str_replace (αναζήτηση $, $ αντικατάσταση, $ περιεχόμενο);
}
add_filter ('the_content', 'renym_content_replace');

Στον παραπάνω κώδικα, έχουμε ήδη επιλέξει τις λέξεις για αντικατάσταση π.χ. wordpress, κατσίκα, Πάσχα κ.λπ. Επιλέξαμε επίσης τις λέξεις αντικατάστασης π.χ. WordPress, καφές, διακοπές του Πάσχα κ.λπ. Ας ελπίσουμε ότι ο κώδικας είναι κάπως αυτονόητος:

  • ο renym_content_replace Η συνάρτηση παίρνει το ($ content) ως όρισμα, αντικαθιστά όλες τις λέξεις που περιέχονται στον πίνακα αναζήτησης $ και επιστρέφει τις λέξεις που έχουν τροποποιηθεί τώρα στο WordPress.
  • Η αναζήτηση $ περιέχει όλες τις λέξεις που πρέπει να αντικατασταθούν
  • Το $ Repl περιέχει τις λέξεις αντικατάστασης
  • Το str_replace κάνει ό, τι κάνει καλύτερα, αντικαθιστώντας τις λέξεις με τις νέες λέξεις

Σημειώστε πώς προσθέτουμε το πρόθεμα ύφος σε κάθε λειτουργία. Αυτό αποτρέπει διενέξεις με άλλα πρόσθετα που ενδέχεται να εγκατασταθούν. Θα πρέπει να συνηθίσετε να προσθέτετε προθέματα στις λειτουργίες σας, είτε αναπτύσσετε προσθήκες, θέματα ή widget.

Εάν έχετε ολοκληρώσει τα παραπάνω βήματα, η προσθήκη σας μπορεί να αντικαταστήσει όλες τις επιλεγμένες λέξεις σας αποτελεσματικά. Τώρα ας προσθέσουμε τη σημείωση “Ευχαριστώ που διαβάσατε αυτό το σεμινάριο …” που θα εμφανίζεται στο κάτω μέρος κάθε ανάρτησης. Προσθέστε τον ακόλουθο κώδικα στο κύριο αρχείο προσθηκών σας ( renym_content_replace ) πριν από το κλείσιμο βραχίονα PHP ( ?> ) Που έρχεται στην τελευταία γραμμή:

function renym_content_footer_note (περιεχόμενο $) {
Περιεχόμενο $. = '
Σας ευχαριστούμε που διαβάσατε αυτό το σεμινάριο. Ίσως την επόμενη φορά να σας αφήσω να αγοράσετε έναν καφέ! Για περισσότερα μαθήματα WordPress επισκεφθείτε το ιστολόγιό μας
"; επιστροφή περιεχομένου $; } add_filter ('the_content', 'renym_content_footer_note');

Αποθηκεύστε τις αλλαγές. ο renym_content_footer_note Η συνάρτηση προσθέτει τη σήμανση HTML στην παράμετρο $ content και επιστρέφει τη νέα τιμή στο WordPress. Προσθέσαμε επίσης μια κλάση υποσέλιδου στο κείμενό μας, ώστε να μπορεί να διαμορφωθεί εύκολα αργότερα.

Έχουμε συμπεριλάβει ένα φίλτρο (add_filter) το οποίο λέει στη λειτουργία μας να λειτουργεί στο κείμενο που επιλέξαμε, το οποίο είναι το περιεχόμενο της ανάρτησης όπως αντιπροσωπεύεται από το_content.

Συμπίεση του φακέλου σας

Σε αυτό το σημείο, ο τελικός σας wp-renym.php το αρχείο πρέπει να έχει την εξής μορφή:

Σας ευχαριστούμε που διαβάσατε αυτό το σεμινάριο. Ίσως την επόμενη φορά να σας αφήσω να αγοράσετε έναν καφέ! Για περισσότερα μαθήματα WordPress επισκεφθείτε το ιστολόγιό μας";
επιστροφή περιεχομένου $;
}
add_filter ('the_content', 'renym_content_footer_note');

?>

Αποθηκεύστε όλες τις αλλαγές σας. Συμπίεση του φακέλου WP Renym σε ένα wp-renym.zip αρχειοθέτηση (σε Mac είναι τόσο εύκολο όσο το δεξί κλικ, συμπίεση αρχείου – και στον υπολογιστή πιστεύω ότι είναι πολύ παρόμοιο). Απλώς βεβαιωθείτε ότι το αρχείο σας αποθηκεύεται ως επέκταση .ZIP ή ότι η προσθήκη δεν θα εγκατασταθεί.

Χρησιμοποιήστε την προσθήκη σας

Ανεβάστε και ενεργοποιήστε το νέο σας WP Renym plugin μέσω του Οθόνη προσθηκών WordPress. Συγχαρητήρια για τη σύνταξη της πρώτης προσθήκης σας!

Εγκαταστήστε το Renym WordPress Plugin

Πόροι

Για να μάθετε περισσότερα πάνω από την ανάπτυξη προσθηκών WordPress, ρίξτε μια ματιά στους παρακάτω πόρους:

συμπέρασμα

Ελπίζω ότι αυτό το σεμινάριο σάς έδειξε τη σωστή κατεύθυνση όσο καταλαβαίνετε τα πρόσθετα. Αυτή η ανάρτηση πρέπει να χρησιμεύσει ως βήμα για την ανάπτυξη σύνθετων plugins WordPress που κάνουν ό, τι θέλετε. Μην σταματήσετε εδώ, δείτε τους πόρους που πρότεινα παραπάνω για να αυξήσετε τις γνώσεις σας σχετικά με την ανάπτυξη προσθηκών WordPress.

Εάν βρήκατε αυτό το σεμινάριο χρήσιμο ή αν έχετε κάτι άλλο να προσθέσουμε, θα θέλαμε να μάθουμε. Μοιραστείτε τις σκέψεις σας στην παρακάτω ενότητα σχολίων. Τα λέμε γύρω around

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me