WordPress-Objekte classnreferenz

In WordPress haben wir mehrere Objekte, die durch ausreichend dokumentierte classn definiert sind.

Dies sind die WP_Query , WPDB , WP_Post und andere.

Es gibt jedoch andere Objekte, die zur Laufzeit tatsächlich erstellt werden, wobei normalerweise ein Array in ein Standardobjekt umgewandelt wird oder aus der DB gelesen wird.

Zum Beispiel das Taxonomieobjekt, das Sie von der function get_taxonomy() .

Obwohl es keine tatsächliche class gibt, die diese Objekte definiert, frage ich mich, ob es eine detaillierte Dokumentation aller Eigenschaften gibt, die wir in diesen Objekten finden können , die mich nicht immer daran hindern, sich im Code zu erinnern, welche Namen die Eigenschaften haben .

Solutions Collecting From Web of "WordPress-Objekte classnreferenz"

Es gibt keine solche Dokumentation, und ich erwarte es auch in absehbarer Zeit nicht. WordPress könnte spezielle Eigenschaftenobjekte für diese Fälle implementieren, für get_taxonomies() könnte es so aussehen:

 class WP_Taxonomy_Properties { private $data; public function __construct( Array $data ) { $this->data = $data; } public function get_labels() { return $this->data['labels']; } public function get_description() {} public function get_public() {} public function get_hierarchical() {} public function get_show_ui() {} public function get_show_in_menu() {} public function get_show_in_nav_menus(){} public function get_show_tagcloud() {} public function get_meta_box_cb() {} public function get_capabilities() {} public function get_rewrite() {} public function get_query_var() {} public function get_update_count_callback() {} public function is_builtin() {} } 

Ihre IDE würde die Methoden dann automatisch vervollständigen. Kein manuelles Nachschlagen mehr nötig.

Aber es gibt mindestens zwei Gründe, warum dies in naher Zukunft nicht passieren wird.

  1. Es gibt wenig Interesse daran, OOP im corecode zu implementieren. Wenn Sie überhaupt ein Objekt finden, ist es zu viel (sehen Sie sich WP_Screen für ein Beispiel an) oder es ist eine Drittanbieterbibliothek (SimplePie).

  2. Es würde eine große Säuberung erfordern, da viele Objekte de facto versteckt sind. Ein Beispiel aus der class Walker_Nav_Menu ; Schauen Sie sich sehr genau $args :

     /** * Start the element output. * * @see Walker::start_el() * * @since 3.0.0 * * @param string $output Passed by reference. Used to append additional content. * @param object $item Menu item data object. * @param int $depth Depth of menu item. Used for padding. * @param array $args An array of arguments. @see wp_nav_menu() * @param int $id Current item ID. */ function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 ) { $indent = ( $depth ) ? str_repeat( "\t", $depth ) : ''; $class_names = $value = ''; $classes = empty( $item->classes ) ? array() : (array) $item->classes; $classes[] = 'menu-item-' . $item->ID; /** * Filter the CSS class(es) applied to a menu item's 
  3. . * * @since 3.0.0 * * @param array $classes The CSS classes that are applied to the menu item's
  4. . * @param object $item The current menu item. * @param array $args An array of arguments. @see wp_nav_menu() */ $class_names = join( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item, $args ) ); $class_names = $class_names ? ' class="' . esc_attr( $class_names ) . '"' : ''; /** * Filter the ID applied to a menu item's
  5. . * * @since 3.0.1 * * @param string The ID that is applied to the menu item's
  6. . * @param object $item The current menu item. * @param array $args An array of arguments. @see wp_nav_menu() */ $id = apply_filters( 'nav_menu_item_id', 'menu-item-'. $item->ID, $item, $args ); $id = $id ? ' id="' . esc_attr( $id ) . '"' : ''; $output .= $indent . '
  7. '; $atts = array(); $atts['title'] = ! empty( $item->attr_title ) ? $item->attr_title : ''; $atts['target'] = ! empty( $item->target ) ? $item->target : ''; $atts['rel'] = ! empty( $item->xfn ) ? $item->xfn : ''; $atts['href'] = ! empty( $item->url ) ? $item->url : ''; /** * Filter the HTML attributes applied to a menu item's . * * @since 3.6.0 * * @param array $atts { * The HTML attributes applied to the menu item's , empty strings are ignored. * * @type string $title The title attribute. * @type string $target The target attribute. * @type string $rel The rel attribute. * @type string $href The href attribute. * } * @param object $item The current menu item. * @param array $args An array of arguments. @see wp_nav_menu() */ $atts = apply_filters( 'nav_menu_link_attributes', $atts, $item, $args ); $attributes = ''; foreach ( $atts as $attr => $value ) { if ( ! empty( $value ) ) { $value = ( 'href' === $attr ) ? esc_url( $value ) : esc_attr( $value ); $attributes .= ' ' . $attr . '="' . $value . '"'; } } $item_output = $args->before; $item_output .= ''; /** This filter is documented in wp-includes/post-template.php */ $item_output .= $args->link_before . apply_filters( 'the_title', $item->title, $item->ID ) . $args->link_after; $item_output .= ''; $item_output .= $args->after; /** * Filter a menu item's starting output. * * The menu item's starting output only includes $args->before, the opening , * the menu item's title, the closing , and $args->after. Currently, there is * no filter for modifying the opening and closing
  8. for a menu item. * * @since 3.0.0 * * @param string $item_output The menu item's starting HTML output. * @param object $item Menu item data object. * @param int $depth Depth of menu item. Used for padding. * @param array $args An array of arguments. @see wp_nav_menu() */ $output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args ); }

$args ist kein Array, es ist eines dieser schlampigen Objekte, die mit type casting in der function wp_nav_menu() : $args = (object) $args; .

Was jetzt? Sie können die Signaturen in Walker_Nav_Menu nicht ändern, da dies eine Walker_Nav_Menu class von Walker (einer der vielen Gründe, warum inheritance ein schlechtes Konzept ist). Durch das Ändern der Unterklasse der E_STRICT Hinweise E_STRICT . Sie können nicht einfach ein Array übergeben, da dies viele Gehhilfen von Drittanbietern stören würde. Wenn Sie neue Objekte einführen, müssen Sie zuerst die classn korrigieren, die sie verwenden. Und es gibt wahrscheinlich viele Fälle wie diesen.