πλαϊνή γραμμή wordpress. Πλαϊνές γραμμές WordPress, δημιουργία πλαϊνής γραμμής WordPress. Προεπιλεγμένα γραφικά στοιχεία WordPress

Εμφανίζει τον πρώτο ενεργό πίνακα γραφικών στοιχείων (η πλευρική γραμμή είναι ένας πίνακας που περιέχει τουλάχιστον ένα γραφικό στοιχείο). Μπορείτε να καθορίσετε το αναγνωριστικό ή τον αριθμό του πίνακα, ποιο θα εμφανίζεται, εάν ο ιστότοπος διαθέτει περισσότερα από ένα πλαίσια γραφικών στοιχείων.

Η dynamic_sidebar() επιστρέφει true ή false, με το αποτέλεσμα επιστροφής να εμφανίζει επίσης τη γραμμή γραφικών στοιχείων. Η τιμή επιστροφής μπορεί να χρησιμοποιηθεί, για παράδειγμα, για να καθοριστεί εάν ο κώδικας που αντικαθιστά τα γραφικά στοιχεία θα πρέπει να υποβάλλεται σε επεξεργασία όταν δεν υπάρχουν γραφικά στοιχεία στον πίνακα (βλ. παράδειγμα #1).

επιστρέφει

αληθεύει εάν βρέθηκε ο πίνακας γραφικών στοιχείων. false εάν ο πίνακας δεν υπάρχει ή δεν περιέχει widget.

Χρήση

Παραδείγματα

#1 Εμφάνιση της πλαϊνής γραμμής εάν υπάρχει.

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

#2 Εμφάνιση της επιθυμητής πλευρικής γραμμής.

#3 Ελέγξτε για την παρουσία του πίνακα και εμφανίστε το

Στο παράδειγμα 2, δεν ελέγξαμε για την παρουσία πίνακα και γραφικών στοιχείων σε αυτό. Σε αυτό το παράδειγμα, θα ελέγξουμε για την παρουσία ενός πίνακα για να μην εμφανιστεί περιττό Ετικέτες HTML (

) εάν η πλαϊνή γραμμή είναι άδεια:

Πολλαπλές πλαϊνές γραμμές

Όταν καταχωρείτε περισσότερα από ένα πάνελ γραφικών στοιχείων με register_sidebar() , είναι πιο βολικό να καθορίσετε ένα αναγνωριστικό για κάθε πίνακα.

Δεν μπορούμε να καθορίσουμε id, τότε ο πίνακας θα λάβει έναν σειριακό αριθμό. Αλλά σε αυτήν την περίπτωση, όταν επεξεργάζεστε το θέμα, θα είναι δύσκολο να καταλάβετε ποιο πάνελ είναι ποιο, επειδή οι αριθμοί 1, 2, 3 δεν σημαίνουν τίποτα. Αλλά αν ορίσετε το όνομα, γίνεται πολύ πιο ξεκάθαρο:

// --- αριθμοί// εγγραφή register_sidebar(); // έξοδος dynamic_sidebar(1); // --- Χορδές// εγγραφή register_sidebar(array("id" => "top_menu")); // output dynamic_sidebar("top_menu");

Από το παράδειγμα, είναι σαφές ότι είναι πιο βολικό με συμβολοσειρές: κοιτάζοντας το θέμα και βλέποντας το dynamic_sidebar("top_menu"), είναι αμέσως σαφές ότι καλείται ο πίνακας για το κύριο μενού.

Το όρισμα id δεν πρέπει να περιέχει κενά, κεφαλαία γράμματα, κυριλλικά γράμματα. Μπορείτε να χρησιμοποιήσετε μια παύλα - και μια υπογράμμιση _ σε αυτήν. Πρέπει επίσης να είναι μοναδικό. Καθορίζοντας το αναγνωριστικό, μπορούμε επίσης να καθορίσουμε το όνομα, την περιγραφή και τις μεταφράσεις τους:

Register_sidebar(array("id" => "top-menu", "name" => __("Top Menu", $text_domain), "description" => __("Αυτή η πλαϊνή γραμμή βρίσκεται πάνω από το λογότυπο ηλικίας.", $text_domain))))

Σημειώσεις

• Παγκόσμια. Πίνακας. $wp_registered_sidebars Εγγεγραμμένες πλαϊνές γραμμές.
• Παγκόσμια. Πίνακας. $wp_registered_widgets

Λίστα αλλαγών

Από την έκδοση 2.2.0

Εισήχθη.

Κώδικας δυναμική πλαϊνή γραμμή: wp-includes/widgets.php WP 5.3.2

$value) ( ​​if (sanitize_title($value["name"]) == $index) ( $index = $key; break; ) ) ) $sidebars_widgets = wp_get_sidebars_widgets(); if (empty($wp_registered_sidebars[ $index ]) || white($sidebars_widgets[ $index ]) || !is_array($sidebars_widgets[ $index ])) ( /** Αυτή η ενέργεια τεκμηριώνεται στο wp-includes/widget. php */ do_action("dynamic_sidebar_before", $index, false); /** Αυτή η ενέργεια τεκμηριώνεται στο wp-includes/widget.php */ do_action("dynamic_sidebar_after", $index, false); /** Αυτό το φίλτρο είναι τεκμηριώνεται στο wp-includes/widget.php */ return apply_filters("dynamic_sidebar_has_widgets", false, $index); ) /** * Ενεργοποιείται πριν από την απόδοση των γραφικών στοιχείων σε μια δυναμική πλαϊνή γραμμή. * * Σημείωση: Η ενέργεια ενεργοποιείται επίσης για κενές πλαϊνές γραμμές και τόσο στο μπροστινό μέρος * όσο και στο πίσω άκρο, συμπεριλαμβανομένης της πλαϊνής γραμμής Ανενεργών γραφικών στοιχείων στην οθόνη Γραφικών στοιχείων. * * @since 3.9.0 * * @param int|string $index Ευρετήριο, όνομα ή αναγνωριστικό της δυναμικής πλαϊνής γραμμής. * @param bool $has_widgets Εάν η πλαϊνή γραμμή είναι γεμάτη με γραφικά στοιχεία. * προεπιλογή true. */ do_action("dynamic_sidebar_before", $index, true); $sidebar = $wp_registered_sidebars[ $index ]; $did_one = false; foreach ((πίνακας) $sidebars_widgets[ $index ] ως $id) ( if (! isset($wp_registered_widgets[ $id ])) (συνέχεια; ) $params = array_merge(array(array_merge($sidebar, array("widget_id") => $id, "widget_name" => $wp_registered_widgets[ $id ]["name"],)),), (πίνακας) $wp_registered_widgets[ $id ]["params"]); // Αντικατάσταση αναγνωριστικού και κλάσης HTML χαρακτηριστικά στο before_widget $classname_ = ""; foreach ((array) $wp_registered_widgets[ $id ]["classname"] ως $cn) ( if (is_string($cn)) ( $classname_ .= "_" . $cn; ) elseif (is_object($cn)) ( $classname_ .= "_" . get_class($cn); ) ) $classname_ = ltrim($classname_, "_"); $params["before_widget"] = sprintf($ params["before_widget"], $id, $classname_); /** * Φιλτράρει τις παραμέτρους που μεταβιβάζονται στην επανάκληση της οθόνης ενός γραφικού στοιχείου. * * Σημείωση: Το φίλτρο αξιολογείται τόσο στο μπροστινό όσο και στο πίσω άκρο, * συμπεριλαμβανομένης της την πλαϊνή γραμμή Inactive Widgets στην οθόνη Widgets.* * @since 2.5.0 * * @δείτε register_sidebar() * * @param array $params ( * @type array $args ( * Μια σειρά από ορίσματα εμφάνισης widget. * * @type string $name Όνομα της πλαϊνής γραμμής στην οποία έχει εκχωρηθεί το γραφικό στοιχείο. * @type string $id ID της πλαϊνής γραμμής στην οποία έχει εκχωρηθεί το widget. * @type string $description Η περιγραφή της πλευρικής γραμμής. * @type string $class κλάση CSS που εφαρμόζεται στο κοντέινερ της πλευρικής γραμμής. * @type string $before_widget Σήμανση HTML για προσάρτηση σε κάθε γραφικό στοιχείο στην πλαϊνή γραμμή. * @type string $after_widget Σήμανση HTML για προσθήκη σε κάθε γραφικό στοιχείο στην πλαϊνή γραμμή. * @type string $before_title Σήμανση HTML για να προσαρτάται στον τίτλο του γραφικού στοιχείου όταν εμφανίζεται. * @type string $after_title Σήμανση HTML για προσθήκη στον τίτλο του γραφικού στοιχείου όταν εμφανίζεται. * @type string $widget_id ID του γραφικού στοιχείου. * @type string $widget_name Όνομα του γραφικού στοιχείου. * ) * @type array $widget_args ( * Μια σειρά από ορίσματα πολλαπλών γραφικών στοιχείων. * * @type int $number Αύξηση αριθμού που χρησιμοποιείται για πολλαπλάσια του ίδιου γραφικού στοιχείου. * ) * ) */ $params = apply_filters("dynamic_sidebar_params", $params); $callback = $wp_registered_widgets[ $id ]["callback"]; /** * Ενεργοποιείται πριν από την επανάκληση της οθόνης ενός γραφικού στοιχείου. * * Σημείωση: Η ενέργεια ενεργοποιείται τόσο στο μπροστινό μέρος όσο και στο πίσω μέρος, συμπεριλαμβανομένου του * για γραφικά στοιχεία στην πλαϊνή γραμμή Ανενεργών γραφικών στοιχείων στην οθόνη Γραφικών στοιχείων. * * Η ενέργεια είναι δεν ενεργοποιείται για κενές πλευρικές μπάρες. * @type array|callable $callback Όταν το άγκιστρο ενεργοποιείται στο μπροστινό μέρος, το $callback είναι ένας πίνακας * που περιέχει το αντικείμενο του γραφικού στοιχείου. Ενεργοποιείται στο πίσω άκρο, το $callback * είναι "wp_widget_control", βλέπε $_callback.* @type array $params Ένας συσχετιστικός πίνακας ορισμάτων πολλαπλών γραφικών στοιχείων.* @type string $classname Η κλάση CSS εφαρμόζεται στο κοντέινερ του widget.* @type string $description Η περιγραφή του widget.* @type array $_callback Όταν το άγκιστρο ενεργοποιείται στο πίσω μέρος τέλος, το $_callback συμπληρώνεται * με έναν πίνακα που περιέχει το αντικείμενο του γραφικού στοιχείου, βλέπε $callback.* ) */ do_action("dynamic_sidebar", $wp_registered_widgets[ $id ]); if (is_callable($callback)) ( call_user_func_array($callback, $params); $did_one = true; ) ) /** * Ενεργοποιείται μετά την απόδοση των γραφικών στοιχείων σε μια δυναμική πλαϊνή γραμμή. * * Σημείωση: Η ενέργεια ενεργοποιείται επίσης για κενές πλαϊνές γραμμές και τόσο στο μπροστινό μέρος * όσο και στο πίσω άκρο, συμπεριλαμβανομένης της πλαϊνής γραμμής Ανενεργών γραφικών στοιχείων στην οθόνη Γραφικών στοιχείων. * * @since 3.9.0 * * @param int|string $index Ευρετήριο, όνομα ή αναγνωριστικό της δυναμικής πλαϊνής γραμμής. * @param bool $has_widgets Εάν η πλαϊνή γραμμή είναι γεμάτη με γραφικά στοιχεία. * προεπιλογή true. */ do_action("dynamic_sidebar_after", $index, true); /** * Φιλτράρει εάν μια πλαϊνή γραμμή έχει γραφικά στοιχεία. * * Σημείωση: Το φίλτρο αξιολογείται επίσης για κενές πλαϊνές γραμμές και τόσο στο μπροστινό μέρος * όσο και στο πίσω άκρο, συμπεριλαμβανομένης της πλαϊνής γραμμής Ανενεργών γραφικών στοιχείων στην οθόνη Γραφικών στοιχείων. * * @since 3.9.0 * * @param bool $did_one Εάν αποδόθηκε τουλάχιστον ένα γραφικό στοιχείο στην πλαϊνή γραμμή. * default false. * @param int|string $index Ευρετήριο, όνομα ή αναγνωριστικό της δυναμικής πλαϊνής γραμμής. */ επιστροφή application_filters("dynamic_sidebar_has_widgets", $did_one, $index); )

Γεια σας φίλοι! Όπως είχα υποσχεθεί, έφτιαξα ένα θέμα Πλαϊνές γραμμές WordPress. Αυτός είναι ένας μικρός οδηγός για τη χρήση και την προσαρμογή των πλευρικών γραμμών σε ιστότοπους WordPress.

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

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

Τι είναι μια πλαϊνή γραμμή WordPress;

Στην πραγματικότητα, ο όρος «sidebar (sidebar)» μπορεί να σημαίνει δύο εντελώς άσχετες έννοιες στο σύστημα WordPress:

1. Δυναμική πλαϊνή γραμμή: ένα κοντέινερ για ένα σύνολο γραφικών στοιχείων που μπορεί να εγκαταστήσει ο χρήστης μέσω του πίνακα διαχείρισης -> ενότητα Γραφικά στοιχεία.
2. Πρότυπο πλευρικής γραμμής: Αυτή είναι η πλαϊνή γραμμή που εμφανίζεται από το πρότυπο τοποθεσίας.

Στις περισσότερες περιπτώσεις, τα απλά πρότυπα έχουν μια δυναμική πλαϊνή γραμμή που φορτώνει όλα τα τοποθετημένα γραφικά στοιχεία από τον πίνακα διαχείρισης. Αυτή η διαδικασία μπορεί επίσης να λάβει χώρα σύμφωνα με άλλον αλγόριθμο, αλλά τις περισσότερες φορές σύμφωνα με αυτό το σχήμα. Ωστόσο, είναι σημαντικό να κατανοήσουμε ότι μια δυναμική πλαϊνή γραμμή και ένα πρότυπο πλαϊνής γραμμής είναι δύο διαφορετικά πράγματα. Όλα είναι premium, δουλεύω κυρίως με το πρότυπο Sidebar.

Συνήθως, ο όρος "sidebar" χρησιμοποιείται σε σχέση με τη δυναμική πλαϊνή γραμμή, η οποία θα συζητηθεί σε αυτό το άρθρο. Ωστόσο, θα αγγίξω και το πρότυπο της πλαϊνής γραμμής.

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

Εγγραφή, προσθήκη και δημιουργία πλαϊνής γραμμής WordPress

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

Για να δημιουργήσετε μία ή περισσότερες πλευρικές γραμμές, θα πρέπει να τις καταχωρήσετε μέσω ενός αρχείου λειτουργίες. phpΤο θέμα σας, κάθε θέμα έχει το δικό του αρχείο που περιέχει όλες τις ρυθμίσεις προτύπου. Να αρχειοθετήσω λειτουργίες. phpΜπορείτε να προσθέσετε ή να αφαιρέσετε ρυθμίσεις θέματος.

Ο παρακάτω κώδικας δείχνει πώς μπορείτε να δημιουργήσετε μια πλαϊνή γραμμή στο WordPress χρησιμοποιώντας τη συνάρτηση register_sidebar(). Σε αυτήν την περίπτωση, θα δημιουργήσουμε μια πλαϊνή γραμμή που ονομάζεται "κύρια" η οποία θα χρησιμεύσει ως παράδειγμα για εργασία.

"κύριο", "όνομα" => __("Κύριο"), "περιγραφή" => __("Περιγραφή πλευρικής γραμμής (ορατή στον πίνακα διαχείρισης)"), "before_widget" => "

", "after_widget" => "
", "before_title" => "

", "after_title" => "

")); /* Μπορείτε να επαναλάβετε τη συνάρτηση register_sidebar() για άλλα γραφικά στοιχεία, το πεδίο id πρέπει να είναι μοναδικό (πρωτεύον, δευτερεύον, moiwidget, κ.λπ. */ ) ?>

add_action("widgets_init" , "registriruem_sidebari" ); συνάρτηση register_sidebari() ( /* Καταχωρίστε την "κύρια" πλευρική γραμμή. */ register_sidebar( πίνακας( "id" => "κύριος" , "name" => __("Κύριο") , "περιγραφή" => __( "Περιγραφή της πλαϊνής γραμμής (ορατή στον πίνακα διαχείρισης).") , "before_widget" => " " , "after_widget" => " " , "before_title" => " " , "after_title" => " " /* Μπορείτε να επαναλάβετε τη συνάρτηση register_sidebar() για άλλα γραφικά στοιχεία, το πεδίο id πρέπει να είναι μοναδικό (πρωτεύον, δευτερεύον, moiwidget, κ.λπ. */

Όπως μπορείτε να δείτε, η εγγραφή μιας πλαϊνής γραμμής είναι μια πολύ απλή εργασία εάν έχετε πληροφορίες για το πώς να το κάνετε.

Επιχειρήματα για τη δημιουργία μιας δυναμικής πλευρικής γραμμής dynamic_sidebar()

Λειτουργία register_sidebar()δέχεται μόνο μία παράμετρο, καλείται $argsκαι περιέχει ένα σύνολο ορισμάτων που καθορίζουν τον τρόπο απόδοσης της πλαϊνής γραμμής με τα γραφικά στοιχεία της. Στη συνέχεια, εξετάστε παραδείγματα χειροκίνητης χρήσης ορισμάτων.

ταυτότητα

Διαφωνία ταυτότητα, είναι ίσως ένα από τα πιο σημαντικά επιχειρήματα για να γράψετε (δείτε το παράδειγμα κακογραμμένου κώδικα παρακάτω και δείτε γιατί πρέπει οπωσδήποτε να τον γράψετε). Το WordPress θα χρησιμοποιήσει ταυτότηταγια να αντιστοιχίσετε γραφικά στοιχεία σε μια συγκεκριμένη πλαϊνή γραμμή και θα χρειαστείτε ταυτότηταγια να γεμίσετε περαιτέρω την πλαϊνή μπάρα - πλαϊνή μπάρα.

Κάθε ταυτότηταπρέπει να είναι μοναδικό. Το WordPress, από προεπιλογή, θα το συνταγογραφήσει πλαϊνή μπάρα-$i(Οπου $ i

//το αναγνωριστικό του γραφικού μας στοιχείου, το οποίο εκχωρείται μόνο μία φορά "id" => "κύριο",

Ονομα

Μπορείτε να γράψετε οποιοδήποτε όνομα πιστεύετε ότι αντιπροσωπεύει καλύτερα το δικό σας πλαϊνή γραμμή WordPress. Τις περισσότερες φορές, στις πλευρικές γραμμές δίνονται ονόματα με τα οποία ο χρήστης μπορεί να προσδιορίσει ποιες πτυχές του θέματος αγγίζει (για παράδειγμα, αριστερή ή δεξιά πλαϊνή γραμμή). Αυτό το όρισμα μπορεί να διεθνοποιηθεί (δηλαδή να προσαρμοστεί για άλλες γλώσσες). Επομένως, φροντίστε να γράψετε τον σωστό τομέα κειμένου όταν προετοιμάζετε το θέμα σας για μετάφραση. Το όρισμα, από προεπιλογή, είναι γραμμένο ως Sidebar $ i(Οπου $ iείναι ο τακτικός αριθμός της πλαϊνής γραμμής που δημιουργήθηκε).

//όνομα γραφικού στοιχείου, στο παράδειγμα χρησιμοποιώ το Κύριο ως όνομα του αναγνωριστικού γραφικού στοιχείου "όνομα" => "Κύριο",

περιγραφή

Διαφωνία περιγραφήπαρουσιάστηκε για πρώτη φορά στο WordPress 2.9. Αυτό το όρισμα σάς επιτρέπει να περιγράψετε το γραφικό στοιχείο σας, η περιγραφή εμφανίζεται στον πίνακα διαχείρισης στην ενότητα Γραφικά στοιχεία. Αυτό το όρισμα, από προεπιλογή, είναι γραμμένο σε μια κενή συμβολοσειρά. Μπορεί επίσης να διεθνοποιηθεί (δηλαδή γραμμένο σε κυριλλικά ή άλλες γλώσσες).

//η περιγραφή θα είναι ορατή στην ενότητα γραφικών στοιχείων "περιγραφή" => __("Γραφικό στοιχείο για την αριστερή στήλη στον ιστότοπο"),

before_widget

Διαφωνία before_widgetαυτό είναι το στοιχείο ανοίγματος του γραφικού στοιχείου που έχει εκχωρηθεί στην πλαϊνή γραμμή. Πρέπει επίσης να είναι στοιχείο επιπέδου μπλοκ HTMLσήμανση (π.χ. ετικέτα < li > , < p > , < div > και τα λοιπά.). Αυτό το όρισμα έχει μερικά χαρακτηριστικά στα οποία μπορείτε να γράψετε για παράδειγμα id=""ή class="": ιδιότητες id=""γράφονται ως εξής: (%1$s)και ιδιότητες class=""Ετσι: (%2$s).

Από προεπιλογή, το WordPress θα τα καταχωρήσει ως στοιχείο λίστας: < li id = "%1$s" > . Δεν είμαι λάτρης της δημιουργίας στοιχείων λίστας γραφικών στοιχείων πλευρικής γραμμής. Χρησιμοποιώ πάντα < div > . Δεν είμαι λάτρης της δημιουργίας στοιχείων λίστας γραφικών στοιχείων πλευρικής γραμμής. Την τελευταία φορά που το χρησιμοποιώ, γιατί ελλείψει widget στον ιστότοπο, δεν θα δείτε επιπλέον HTMLετικέτες, ωστόσο, περαιτέρω θα εξετάσουμε πώς να απαλλαγούμε από αυτές.

after_widget

Διαφωνία after_widgetαρκετά εύκολο στη δημιουργία. Αυτό είναι το στοιχείο κλεισίματος για το γραφικό στοιχείο που έχει εκχωρηθεί στην πλαϊνή γραμμή. Απλώς πρέπει να κλείσετε το στοιχείο που καθορίζεται για το όρισμα before_widget. Από προεπιλογή, το WordPress θα το γράψει ως < li > .

"after_widget" => "