Merge branch 'master' of github.com:szepeviktor/phpstan-wordpress

Author: szepeviktor

.editorconfig

@@ -11,7 +11,7 @@ indent_style = space
 indent_size = 4
 
 [*.{xml,xml.dist}]
-indent_style = tab
+indent_style = space
 indent_size = 4
 
 [*.{neon,neon.dist}]

example/class-wp-nav-menu-args-stdclass.php

@@ -0,0 +1,147 @@
+<?php
+/**
+ * Value object for displaying navigation menus.
+ *
+ * Created to aid static analysis by PHPStan.
+ *
+ * @package WordPress
+ * @see wp_nav_menu()
+ */
+
+/**
+ * Nav menu arguments extending stdClass.
+ */
+class WP_Nav_Menu_Args extends stdClass {
+
+	/**
+	 * Desired menu. Accepts a menu ID, slug, name, or object. Default empty.
+	 *
+	 * @var int|string|\WP_Term
+	 */
+	public $menu;
+
+	/**
+	 * CSS class to use for the ul element which forms the menu. Default 'menu'.
+	 *
+	 * @var string
+	 */
+	public $menu_class;
+
+	/**
+	 * The ID that is applied to the ul element which forms the menu.
+	 * Default is the menu slug, incremented.
+	 *
+	 * @var string
+	 */
+	public $menu_id;
+
+	/**
+	 * Whether to wrap the ul, and what to wrap it with. Default 'div'.
+	 *
+	 * @var string
+	 */
+	public $container;
+
+	/**
+	 * Class that is applied to the container. Default 'menu-{menu slug}-container'.
+	 *
+	 * @var string
+	 */
+	public $container_class;
+
+	/**
+	 * The ID that is applied to the container. Default empty.
+	 *
+	 * @var string
+	 */
+	public $container_id;
+
+	/**
+	 * The aria-label attribute that is applied to the container when it's a nav element.
+	 *
+	 * @var string
+	 */
+	public $container_aria_label;
+
+	/**
+	 * If the menu doesn't exists, a callback function will fire.
+	 * Default is 'wp_page_menu'. Set to false for no fallback.
+	 *
+	 * @var callable|bool
+	 */
+	public $fallback_cb;
+
+	/**
+	 * Text before the link markup. Default empty.
+	 *
+	 * @var string
+	 */
+	public $before;
+
+	/**
+	 * Text after the link markup. Default empty.
+	 *
+	 * @var string
+	 */
+	public $after;
+
+	/**
+	 * Text before the link text. Default empty.
+	 *
+	 * @var string
+	 */
+	public $link_before;
+
+	/**
+	 * Text after the link text. Default empty.
+	 *
+	 * @var string
+	 */
+	public $link_after;
+
+	/**
+	 * Whether to echo the menu or return it. Default true.
+	 *
+	 * @var bool
+	 */
+	public $echo;
+
+	/**
+	 * How many levels of the hierarchy are to be included. 0 means all.
+	 * Default 0.
+	 *
+	 * @var int
+	 */
+	public $depth;
+
+	/**
+	 * Instance of a custom walker class. Default empty.
+	 *
+	 * @var \Walker_Nav_Menu
+	 */
+	public $walker;
+
+	/**
+	 * Theme location to be used. Must be registered with register_nav_menu()
+	 * in order to be selectable by the user.
+	 *
+	 * @var string
+	 */
+	public $theme_location;
+
+	/**
+	 * How the list items should be wrapped. Default is a ul with an id and class.
+	 * Uses printf() format with numbered placeholders.
+	 *
+	 * @var string
+	 */
+	public $items_wrap;
+
+	/**
+	 * Whether to preserve whitespace within the menu's HTML. Accepts 'preserve' or 'discard'.
+	 * Default 'preserve'.
+	 *
+	 * @var string
+	 */
+	public $item_spacing;
+}

example/class-wp-nav-menu-item-wp-post.php

@@ -0,0 +1,160 @@
+<?php
+/**
+ * Value object for nav menu item objects.
+ *
+ * Created to aid static analysis by PHPStan.
+ *
+ * @package WordPress
+ * @see wp_setup_nav_menu_item()
+ */
+
+/**
+ * Extends *final* WP_Post class with the shared navigation menu item properties.
+ */
+class WP_Nav_Menu_Item extends WP_Post {
+
+	/**
+	 * The term_id if the menu item represents a taxonomy term.
+	 *
+	 * @overrides WP_Post
+	 * @var int
+	 */
+	public $ID;
+
+	/**
+	 * The title attribute of the link element for this menu item.
+	 *
+	 * @var string
+	 */
+	public $attr_title;
+
+	/**
+	 * The array of class attribute values for the link element of this menu item.
+	 *
+	 * @var array
+	 */
+	public $classes;
+
+	/**
+	 * The DB ID of this item as a nav_menu_item object, if it exists (0 if it doesn't exist).
+	 *
+	 * @var int
+	 */
+	public $db_id;
+
+	/**
+	 * The description of this menu item.
+	 *
+	 * @var string
+	 */
+	public $description;
+
+	/**
+	 * The DB ID of the nav_menu_item that is this item's menu parent, if any. 0 otherwise.
+	 *
+	 * @var int
+	 */
+	public $menu_item_parent;
+
+	/**
+	 * The type of object originally represented, such as "category," "post", or "attachment."
+	 *
+	 * @var string
+	 */
+	public $object;
+
+	/**
+	 * The DB ID of the original object this menu item represents,
+	 * e.g. ID for posts and term_id for categories.
+	 *
+	 * @var int
+	 */
+	public $object_id;
+
+	/**
+	 * The DB ID of the original object's parent object, if any (0 otherwise).
+	 *
+	 * @overrides WP_Post
+	 * @var int
+	 */
+	public $post_parent;
+
+	/**
+	 * A "no title" label if menu item represents a post that lacks a title.
+	 *
+	 * @overrides WP_Post
+	 * @var string
+	 */
+	public $post_title;
+
+	/**
+	 * The target attribute of the link element for this menu item.
+	 *
+	 * @var string
+	 */
+	public $target;
+
+	/**
+	 * The title of this menu item.
+	 *
+	 * @var string
+	 */
+	public $title;
+
+	/**
+	 * The family of objects originally represented, such as "post_type" or "taxonomy."
+	 *
+	 * @var string
+	 */
+	public $type;
+
+	/**
+	 * The singular label used to describe this type of menu item.
+	 *
+	 * @var string
+	 */
+	public $type_label;
+
+	/**
+	 * The URL to which this menu item points.
+	 *
+	 * @var string
+	 */
+	public $url;
+
+	/**
+	 * The XFN relationship expressed in the link of this menu item.
+	 *
+	 * @var string
+	 */
+	public $xfn;
+
+	/**
+	 * Whether the menu item represents an object that no longer exists.
+	 *
+	 * @var bool
+	 */
+	public $_invalid; // phpcs:ignore PSR2.Classes.PropertyDeclaration.Underscore
+
+	/**
+	 * Whether the menu item represents the active menu item.
+	 *
+	 * @var bool
+	 */
+	public $current;
+
+	/**
+	 * Whether the menu item represents an parent menu item.
+	 *
+	 * @var bool
+	 */
+	public $current_item_parent;
+
+	/**
+	 * Whether the menu item represents an ancestor menu item.
+	 *
+	 * @var bool
+	 */
+	public $current_item_ancestor;
+
+}