Πώς να δημιουργήσετε το δικό σας WordPress Shortcodes
Στην έκδοση 2.5 WordPress εισήγαγε shortcodes, και όλοι μας έχουν χρησιμοποιήσει ίσως κάποια στιγμή. Συνήθως συνοδεύονται από plugins ή ακόμα και από θέματα και αυτό που κάνουν είναι να προσέχουν όταν εισάγετε κάτι μέσα σε αγκύλες και στη συνέχεια να το αντικαταστήσετε με κάποιο άλλο περιεχόμενο. θα μπορούσε να είναι μια απλή πρόταση ή θα μπορούσε να είναι μια τεράστια λειτουργία PHP, όλα εξαρτώνται από αυτό που έχετε δώσει οδηγίες στο WordPress να κάνει.
Τα σύνθετα shortcodes είναι υπέροχα και επιταχύνουν τα πράγματα σημαντικά, αλλά δεν θα ήταν ωραίο να γνωρίζετε πώς να δημιουργείτε δικά σας shortcodes;
Σε αυτό το άρθρο θα σας μεταφέρω δημιουργώντας μερικά απλά shortcodes του WordPress για να σας βοηθήσουν να δημιουργήσετε οποιαδήποτε λειτουργικότητα θέλετε.
Ένας απλός κωδικός
Το API shortcode λειτουργεί πολύ απλά: πρώτα πρέπει να δημιουργήσετε μια λειτουργία επανάκλησης που θα τρέξει οποτεδήποτε χρησιμοποιείται ο shortcode. τότε θα πρέπει να συνδέσετε αυτή τη λειτουργία με ένα συγκεκριμένο shortcode που θα είναι έτοιμο για χρήση. Ο κώδικας τοποθετείται συχνά στο αρχείο functions.php, αλλά αν σκοπεύετε να έχετε πολλούς shortcodes, είναι λογικό να δημιουργήσετε ένα ξεχωριστό αρχείο και να το συμπεριλάβετε στο αρχείο functions.php.
Στο πρώτο μας παράδειγμα, θέλουμε να δημιουργήσουμε ένα shortcode που θα δημιουργήσει κάποια lorem ipsum κάθε φορά που πληκτρολογούμε [lorem] στον επεξεργαστή. Πρώτα πρέπει να δημιουργήσουμε τη συνάρτηση επανάκλησης που θα επιστρέψει το lorem ipsum (σε shortcodes δεν αντανακλάμε τίποτα, όλα επιστρέφονται):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}Στη συνέχεια πρέπει να προσθέσουμε αυτό το shortcode στο WordPress χρησιμοποιώντας τη συνάρτηση add_shortcode στο αρχείο functions.php ή σε ένα αρχείο που συμπεριλαμβάνεται σε αυτό. Η συνάρτηση αυτή προσθέτει τον shortcode και συνδέει τη λειτουργία με τη λειτουργία που μόλις δημιουργήσαμε. Το add_shortcode παίρνει μόνο δύο επιχειρήματα, το πρώτο είναι το όνομα που θέλουμε αυτό το shortcode να έχει (τι θα πληκτρολογήσουμε μεταξύ των αγκύλων) και το δεύτερο είναι η συνάρτηση που θέλουμε να επισυνάψουμε σε αυτό το shortcode:
add_shortcode('lorem', 'lorem_function');Αυτό είναι το μόνο που χρειάζεται για να δημιουργήσετε ένα απλό shortcode στο WordPress.
Προσθήκη παραμέτρων
Συνεχίζοντας με αυτήν την εικονική ιδέα περιεχομένου, συχνά χρειαζόμαστε εικόνες στο περιεχόμενό μας όταν προετοιμάζουμε τα mockups μας και αυτές οι εικόνες πρέπει να είναι διαφορετικά μεγέθη, οπότε τώρα θα δημιουργήσουμε ένα shortcode για να εισαγάγουμε μια εικόνα όπως αυτή:
[picture width="500" height="500"]Όταν το WordPress συναντά αυτό θέλουμε μια λειτουργία που θα εισάγει μια εικόνα. Πρέπει να διαβάσει τις ιδιότητες πλάτους και ύψους, αλλά μόνο σε περίπτωση που θα δώσουμε επίσης προεπιλεγμένες τιμές ώστε να μπορούν να χρησιμοποιηθούν χωρίς τα χαρακτηριστικά. Επειδή ενδέχεται να μην έχουμε διαθέσιμη εικόνα, θα χρησιμοποιήσουμε το lorempixel.com υπηρεσία για να μας παράσχει μια τυχαία εικόνα.
Πρώτα πρέπει να δημιουργήσουμε τη λειτουργία:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Ονομάσαμε αυτή τη λειτουργία random_picture και αφού αυτός ο shortcode θα είναι σε θέση να πάρει τα επιχειρήματα που του δώσαμε την παράμετρο $ atts . Για να χρησιμοποιήσουμε τα χαρακτηριστικά, χρειαζόμαστε δύο λειτουργίες: το shortcode_atts που είναι μια συνάρτηση WordPress που συνδυάζει τα γνωρίσματά μας με γνωστά χαρακτηριστικά και συμπληρώνει τις προεπιλογές όταν χρειάζεται. και τη συνάρτηση εξαγωγής PHP, η οποία, όπως υποδηλώνει το όνομα, εξάγει αυτά τα χαρακτηριστικά που ορίσαμε για τον shortcode μας. Τέλος, η συνάρτηση επιστρέφει την τιμή που θέλουμε, στην περίπτωση αυτή τον κώδικα HTML για την εικόνα μας σε συνδυασμό με τις μεταβλητές πλάτους και ύψους.
Το μόνο που πρέπει να κάνετε είναι να καταχωρήσετε αυτόν τον κωδικό:
add_shortcode('picture', 'random_picture');Ο σύντομος κωδικός μας είναι πλήρης, όταν πληκτρολογούμε [εικόνα] θα μας δώσει μια τυχαία εικόνα 400 με 200 και αν χρησιμοποιήσουμε τα χαρακτηριστικά μπορούμε να δημιουργήσουμε μια εικόνα οποιουδήποτε μεγέθους σας παρακαλούμε.
συμπέρασμα
Δημιουργώντας λίγο shortcodes για τα πράγματα που χρησιμοποιούμε συχνά σίγουρα μας βοηθάει όταν γράφουμε αναρτήσεις ιστολογίου γιατί μπορείτε να κάνετε ό, τι παρακαλώ με shortcodes, μπορεί να είναι τόσο απλό όσο επιστρέφει μια πρόταση, ή τόσο περίπλοκο όσο προσθέτοντας μια φόρμα ή τις τελευταίες δημοσιεύσεις ταξινομημένες ανά μήνα.
Έχετε δημιουργήσει χρήσιμες shortcodes για το WordPress; Ποιες shortcodes θέλετε να υπάρχουν; Ενημερώστε μας στα σχόλια.
Προτεινόμενη εικόνα / μικρογραφία, εικόνα κώδικα μέσω του Marjan Krebelj.