Changeset 2003543

a-z-listing/trunk/Gruntfile.js

r1939419	r2003543
94	94	dist: {
95	95	files: {
96		'css/a-z-listing-default.css': 'css/a-z-listing-default.scss'
	96	'css/a-z-listing-default.css': 'css/a-z-listing-default.scss',
	97	'css/a-z-listing-customize.css': 'css/a-z-listing-customize.scss'
97	98	}
98	99	}

a-z-listing/trunk/README.md

-                      r1942709
+                      r2003543
 **Requires at least:** 4.6
 **Requires PHP:** 5.6
 **Tested up to:** 4.9
 **Stable tag:** 2.0.5
+**Tested up to:** 5.0
+**Stable tag:** 2.1.0
 **License:** GPLv2 or later
 **License URI:** http://www.gnu.org/licenses/gpl-2.0.html
 …
 ### How do I show posts of a different post-type (not pages) or multiple post-types (e.g. posts AND pages) ###
 This can be achieved using the shortcode or PHP.
+This can be achieved using the shortcode or PHP. In these examples the generic phrase `post-type-slug` is used to describe the concept. The default post types provided by WordPress are called "Posts" and "Pages". Their slugs are `post` and `page` respectively. You need to use these names in place of the examples (i.e. `your-post-type-slug`, `type1-slug`, and `type1-slug`).
 #### Shortcode method ####
 …
 ```
 The argument to `the_a_z_listing()` is an [array](http://php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
+The argument to `the_a_z_listing()` is an [array](https://secure.php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
 The code above needs to be within a php block which is denoted by the `<?php` and `?>` pair. Depending on your theme, you might not need the opening and closing php tags shown in the above snippet; if that is the case, you are free to omit them in your code.
 …
 ### How do I show posts from a specific category only ###
 This can be achieved using the shortcode or PHP.
+This can be achieved using the shortcode or PHP. In these examples the generic phrase `taxonomy` and `term` are used to describe the concept. The default taxonomies provided by WordPress are called "Categories" and "Tags". Their slugs are `category` and `post_tag` respectively. Each Category and Tag are then known as "terms". You need to use the slug for each individual category or tag in place of the example slugs (i.e. `term-slug`, `term1-slug`, and `term1-slug`).
 #### Shortcode method ####
 …
 ```
 Any number of terms may be added to the `terms` [array](http://php.net/manual/en/language.types.array.php), including one or none.
 The argument to `the_a_z_listing()` is an [array](http://php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
+Any number of terms may be added to the `terms` [array](https://secure.php.net/manual/en/language.types.array.php), including one or none.
+The argument to `the_a_z_listing()` is an [array](https://secure.php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
 The code above needs to be within a php block which is denoted by the `<?php` and `?>` pair. Depending on your theme, you might not need the opening and closing php tags shown in the above snippet; if that is the case, you are free to omit them in your code.
 …
 ### How do I show terms from a taxonomy instead of posts ###
 This can be achieved using the shortcode or PHP.
+This can be achieved using the shortcode or PHP. In these examples the generic phrase `taxonomy` and `term` are used to describe the concept. The default taxonomies provided by WordPress are called "Categories" and "Tags". Their slugs are `category` and `post_tag` respectively. You need to use the slug for the taxonomy in place of the example slugs (i.e. `taxonomy-slug`).
 #### Shortcode method ####
 …
 ```
 The argument to `the_a_z_listing()` is a [string](http://php.net/manual/en/language.types.string.php) and contains the slug of a single taxonomy, e.g. `category` or `post_tag`.
+The argument to `the_a_z_listing()` is a [string](https://secure.php.net/manual/en/language.types.string.php) and contains the slug of a single taxonomy, e.g. `category` or `post_tag`.
 The code above needs to be within a php block which is denoted by the `<?php` and `?>` pair. Depending on your theme, you might not need the opening and closing php tags shown in the above snippet; if that is the case, you are free to omit them in your code.
 …
 ```php
 <?php
 add_action( 'wp', 'a_z_listing_force_enable_styles', 99 );
+add_action( 'init', 'a_z_listing_force_enable_styles', 99 );
 ?>
 ```
 …
 ```php
 <?php
 add_action( 'wp', 'your_override_wrapper_function', 99 );
+add_action( 'init', 'your_override_wrapper_function', 99 );
 function your_override_wrapper_function() {
     if ( ! is_page( 'your-a-z-listing-page-slug-or-ID' ) ) { // ID is numeric, slug is a string.
 …
 ## Changelog ##
+### 2.1.0 ###
+#### Bug Fixes: ####
+* Fix widget configuration autocomplete fields for target post and parent post in the theme customizer
+* Fix taxonomy-term-filtered listings displaying all posts (e.g. shortcodes of the form `[a-z-listing taxonomy="category" terms="term"])
+* Fix `get_the_item_object()` to work with old-style overridden indices
+* Fix `get_the_item_object()` to correctly extract the item ID and load the correct item
+* Improve javascript on the widget configuration
+* Clarified the examples with explanations about "post types", "taxonomies", and "terms" to explain what each of these mean.
+#### New Features: ####
+* Add parent-page attribute to the shortcode
+* Add simpler and safer filter for overriding the index letter for an item
+* Add simpler and safer filter for overriding the title for an item
+* Add new function for fetching meta data in a template: `$a_z_listing->get_item_meta()`
+* Allow exclude-terms to be used with display="posts"
+* Moved template loading function outside of the `A_Z_Query` class to prevent accidental access to the plugin internal structure
 ### 2.0.6 ###
-* *Personal Note:* Sorry to everyone who upgraded to 2.0.0 thru to 2.0.5 about yet another update. I have failed you all by shipping faulty versions to you, and I'm sorry, especially so that you've had to endure so many updates the past few days.
 * Fix widget target post support
 * Fix filtering posts by multiple taxonomy terms
 …
 * Fix javascript error on widgets screen
 ##### 2.0.0 also introduced the following changes: #####
+### 2.0.0 ###
 * Improved widget configuration.
 …
 * Fix the stylesheet to better cope with variances in font-size and text length in the alphabet links list and widget.
 * Introduce PHP classes for adding numbers and grouping to the alphabet. Allows unhooking from the filters to undo the changes, where previously you could not unhook these modifications once they'd been applied.
+* **BREAKING CHANGES:**
+  * Multi column example:
+    If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+    If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+    If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+  * Template customisations:
+    If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+    If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+    To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+    **The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.**
+    *This step is purposely omitted to save memory and try to improve performance.*
+### 2.0.0 ###
+* Improved widget configuration.
+* New attribute added to the shortcode when `display="posts"`:
+  * `exclude-posts`: remove specific posts from the list
+* New attributes added to the shortcode when `display="terms"`:
+  * `exclude-terms`: sets the terms to exclude from display
+  * `parent-term`: set the parent that all displayed terms must be organised under
+  * `hide-empty-terms`: hide terms that have no posts associated
+* Fix the stylesheet to better cope with variances in font-size and text length in the alphabet links list and widget.
+* Introduce PHP classes for adding numbers and grouping to the alphabet. Allows unhooking from the filters to undo the changes, where previously you could not unhook these modifications once they'd been applied.
+* **BREAKING CHANGES:**
+  * Multi column example:
+    If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+    If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+    If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+  * Template customisations:
+    If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+    If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+    To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+    **The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.**
+    *This step is purposely omitted to save memory and try to improve performance.*
+### 1.9.2 ###
+Bugfix:
+* Fix using multiple terms in the shortcode only displays results for the first term
+### 1.9.1 ###
+Feature Request:
+Add CSS classes to letters indicating presence of posts or not:
+* `has-posts` allows styling of letters that have posts visible in the listing
+* `no-posts` allows styling of letters that do not have any posts visible in the listing
+You can use these classes to hide letters that have no posts by including the following CSS rule:
+`.az-letters ul.az-links li.no-posts {
+    display: none;
+}`
+### 1.9.0 ###
+* Fix multi-column example template
+* Update multi-column styles to include display:grid support
+* Add back-to-top link
+* Add server system requirements to readme
+* Add PHP section to readme including link to API Reference
+#### BREAKING CHANGES: ####
+##### Multi column example: #####
+* If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+* If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+* If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+##### Template customisations: #####
+* If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+* If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+* To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+  __The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.__
+  _This step is purposely omitted to save memory and try to improve performance._
 ### Previous ###

a-z-listing/trunk/a-z-listing.php

r1942709	r2003543
8	8	* Text Domain: a-z-listing
9	9	* Domain Path: /languages
10		* Version: 2.~~0.6~~
	10	* Version: 2.1.0
11	11	*
12	12	* @package A_Z_Listing

a-z-listing/trunk/changelog.md

-                      r1942709
+                      r2003543
 # Full Changelog #
+### 2.0.6 ###
+* *Personal Note:* Sorry to everyone who upgraded to 2.0.0 thru to 2.0.4 about yet another update. I have failed you all by shipping faulty versions to you, and I'm sorry, especially so that you've had to endure so many updates the past few days.
+## 2.1.0 ##
+### Bug Fixes ###
+* Fix widget configuration autocomplete fields for target post and parent post in the theme customizer
+* Fix taxonomy-term-filtered listings displaying all posts (e.g. shortcodes of the form `[a-z-listing taxonomy="category" terms="term"])
+* Fix `get_the_item_object()` to work with old-style overridden indices
+* Fix `get_the_item_object()` to correctly extract the item ID and load the correct item
+* Improve javascript on the widget configuration
+* Clarified the examples with explanations about "post types", "taxonomies", and "terms" to explain what each of these mean.
+### New Features ###
+* Add parent-page attribute to the shortcode
+* Add simpler and safer filter for overriding the index letter for an item
+* Add simpler and safer filter for overriding the title for an item
+* Add new function for fetching meta data in a template: `$a_z_listing->get_item_meta()`
+* Allow exclude-terms to be used with display="posts"
+* Moved template loading function outside of the `A_Z_Query` class to prevent accidental access to the plugin internal structure
+## 2.0.6 ##
+* *Personal Note:* Sorry to everyone who upgraded to 2.0.0 thru to 2.0.5 about yet another update. I have failed you all by shipping faulty versions to you, and I'm sorry, especially so that you've had to endure so many updates the past few days.
 * Fix widget target post support
 ### 2.0.5 ###
+## 2.0.5 ##
 * Fix filtering posts by multiple taxonomy terms
 ### 2.0.4 ###
+## 2.0.4 ##
 * Fix styling error causing two or more posts to sometimes appear on the same line
 ### 2.0.3 ###
+## 2.0.3 ##
 * Minor style tweak to fix short listings, and long titles
 ### 2.0.2 ###
+## 2.0.2 ##
 * Fix broken styling in 2.0.0
 ### 2.0.1 ###
+## 2.0.1 ##
 * Fix javascript error on widgets screen
 ### 2.0.0 ###
+## 2.0.0 ##
 * Improved widget configuration.
 …
 * Fix the stylesheet to better cope with variances in font-size and text length in the alphabet links list and widget.
 * Introduce PHP classes for adding numbers and grouping to the alphabet. Allows unhooking from the filters to undo the changes, where previously you could not unhook these modifications once they'd been applied.
+* **BREAKING CHANGES:**
+  * Multi column example:
+    If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+    If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+    If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+  * Template customisations:
+    If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+    If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+    To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+    **The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.**
+    *This step is purposely omitted to save memory and try to improve performance.*
+### BREAKING CHANGES ###
+* Multi column example:
+  If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+  If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+  If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+* Template customisations:
+  If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+  If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+  To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+  **The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.**
+  *This step is purposely omitted to save memory and try to improve performance.*
 ## 1.9.1 ##

a-z-listing/trunk/classes/class-a-z-listing-grouping.php

-                      r1939419
+                      r2003543
      */
     private $headings;
+    /**
+     * Perform a multibyte substring operation if mbstring is loaded, else use substr.
+     *
+     * @since 2.1.0
+     * @param string $string The string to extract the substring from.
+     * @param int    $start Start the substring at this character number (starts at zero).
+     * @param int    $length Number of characters to include in the substring.
+     */
+    public static function maybe_mb_substr( $string, $start, $length ) {
+        if ( extension_loaded( 'mbstring' ) ) {
+            return mb_substr( $string, $start, $length, 'UTF-8' );
+        }
+        return substr( $string, $start, $length );
+    }
     /**
 …
     public function alphabet_filter( $alphabet ) {
         $headings = array();
         $letters  = mb_split( ',', $alphabet );
+        $letters  = explode( ',', $alphabet );
         $letters  = array_map( 'trim', $letters );
 …
                     $carry[ $j ] = $carry[ $j ] . $letter;
+                }
                 $headings[ $j ][] = mb_substr( $letter, 0, 1 );
+                $headings[ $j ][] = A_Z_Listing_Grouping::maybe_mb_substr( $letter, 0, 1 );
                 if ( $i + 1 === $grouping ) {

a-z-listing/trunk/classes/class-a-z-listing-indices.php

-                      r1939419
+                      r2003543
     /**
+     * Get the first letter of a title for use as the Index letter
+     *
+     * @since 2.1.0
+     * @param string $title The title of the item to extract the index letter from.
+     */
+    public static function get_index_letter( $title ) {
+        if ( extension_loaded( 'mbstring' ) ) {
+            return mb_substr( $title, 0, 1, 'UTF-8' );
+        }
+        return substr( $title, 0, 1 );
+    }
+    /**
      * Find and return the index letter for a post
+     *
 …
+        }
+        $index = mb_substr( $title, 0, 1, 'UTF-8' );
+        /**
+         * Modify the title for this item before indexing
+         *
+         * @since 2.1.0
+         * @param string          $title The current title
+         * @param WP_Term|WP_Post $item The item
+         * @param string          $item_type The type of the item. Either 'posts' or 'terms'.
+         */
+        $title = apply_filters( 'a-z-listing-pre-index-item-title', $title, $item, $type );
+        $indices[ $index ][] = array(
+            'title' => $title,
+            'item'  => ( 'terms' === $type ) ? "term:{$item_id}" : "post:{$item_id}",
+            'link'  => $permalink,
+        );
+        /**
+         * Modify the title for this item before indexing
+         *
+         * @since 2.1.0
+         * @param string          $title The current title
+         * @param WP_Term|WP_Post $item The item
+         * @param string          $item_type The type of the item. Either 'posts' or 'terms'.
+         */
+        $title = apply_filters( 'a_z_listing_pre_index_item_title', $title, $item, $type );
+        $index = self::get_index_letter( $title );
+        /**
+         * Modify the indice(s) to group this item under
+         *
+         * @since 2.1.0
+         * @param array           $indices The current indices
+         * @param WP_Term|WP_Post $item The item
+         * @param string          $item_type The type of the item. Either 'posts' or 'terms'.
+         */
+        $index_letters = apply_filters( 'a-z-listing-item-index-letter', array( $index ), $item, $type );
+        /**
+         * Modify the indice(s) to group this item under
+         *
+         * @since 2.1.0
+         * @param array           $indices The current indices
+         * @param WP_Term|WP_Post $item The item
+         * @param string          $item_type The type of the item. Either 'posts' or 'terms'.
+         */
+        $index_letters = apply_filters( 'a_z_listing_item_index_letter', $index_letters, $item, $type );
+        foreach ( $index_letters as $letter ) {
+            $indices[ $letter ][] = array(
+                'title' => $title,
+                'item'  => ( 'terms' === $type ) ? "term:{$item_id}" : "post:{$item_id}",
+                'link'  => $permalink,
+            );
+        }
         if ( 'terms' === $type ) {
 …
              * Modify the indice(s) to group this term under
+             *
              * @deprecated Use a_z_listing_item_indices
              * @see a_z_listing_item_indices
+             * @deprecated Use a_z_listing_item_index_letter and/or a_z_listing_item_title
+             * @see a_z_listing_item_index_letter, a_z_listing_item_title
              */
             $indices = apply_filters_deprecated( 'a_z_listing_term_indices', array( $indices, $item ), '1.0.0', 'a_z_listing_item_indices' );
+            $indices = apply_filters_deprecated( 'a_z_listing_term_indices', array( $indices, $item ), '1.0.0', 'a_z_listing_item_index_letter' );
         } else {
             /**
              * Modify the indice(s) to group this post under
+             *
              * @deprecated Use a_z_listing_item_indices
              * @see a_z_listing_item_indices
+             * @deprecated Use a_z_listing_item_index_letter and/or a_z_listing_item_title
+             * @see a_z_listing_item_index_letter, a_z_listing_item_title
              */
             $indices = apply_filters_deprecated( 'a_z_listing_post_indices', array( $indices, $item ), '1.5.0', 'a_z_listing_item_indices' );
+            $indices = apply_filters_deprecated( 'a_z_listing_post_indices', array( $indices, $item ), '1.5.0', 'a_z_listing_item_index_letter' );
         } // End if.
 …
          * Modify the indice(s) to group this item under
+         *
+         * @since 1.7.0
+         * @since 2.1.0 Deprecated
+         * @deprecated Use a_z_listing_item_index_letter and/or a_z_listing_item_title
+         * @see a_z_listing_item_index_letter, a_z_listing_item_title
          * @param array           $indices The current indices
          * @param WP_Term|WP_Post $item The item
          * @param string          $item_type The type of the item. Either 'posts' or 'terms'.
          */
         $indices = apply_filters( 'a_z_listing_item_indices', $indices, $item, $type );
+        $indices = apply_filters_deprecated( 'a_z_listing_item_indices', array( $indices, $item, $type ), '2.1.0', 'a_z_listing_item_index_letter' );
         /**
 …
+         *
          * @since 1.7.1
+         * @since 2.1.0 Deprecated
+         * @deprecated Use a_z_listing_item_index_letter and/or a_z_listing_item_title
+         * @see a_z_listing_item_index_letter, a_z_listing_item_title
          * @param array           $indices The current indices
          * @param WP_Term|WP_Post $item The item
          * @param string          $item_type The type of the item. Either 'posts' or 'terms'.
          */
         $indices = apply_filters( 'a-z-listing-item-indices', $indices, $item, $type );
+        $indices = apply_filters_deprecated( 'a-z-listing-item-indices', array( $indices, $item, $type ), '2.1.0', 'a_z_listing_item_index_letter' );
         if ( AZLISTINGLOG > 2 ) {

a-z-listing/trunk/classes/class-a-z-listing-numbers.php

-                      r1939419
+                      r2003543
 class A_Z_Listing_Numbers {
     /**
+     * Where to place the numbers.
+     *
+     * @var string
+     */
+    protected $position = 'hide';
+    /**
+     * Whether to group the numbers in a single entry.
+     *
+     * @var boolean
+     */
+    protected $group = false;
+    /**
      * Add filters to append or prepend numbers to the alphabet with optional grouping
+     *
 …
      * @param bool   $group Whether to group the numbers into a single heading or individually.
      */
+    public function __construct( $position = 'after', $group = false ) {
+        $this->position = $position;
+        $this->group    = $group;
+        add_filter( 'a-z-listing-alphabet', array( $this, 'add_to_alphabet' ) );
+        add_filter( 'the-a-z-letter-title', array( $this, 'title' ) );
+    public function __construct( $position = 'hide', $group = false ) {
+        if ( 'before' === $position || 'after' === $position ) {
+            $this->position = $position;
+            $this->group    = a_z_listing_is_truthy( $group );
+            add_filter( 'a-z-listing-alphabet', array( $this, 'add_to_alphabet' ) );
+            add_filter( 'the-a-z-letter-title', array( $this, 'title' ) );
+        }
+    }
 …
      */
     public function add_to_alphabet( $alphabet ) {
+        $numbers = '0,1,2,3,4,5,6,7,8,9';
+        if ( 'hide' === $this->position ) {
+            return $alphabet;
+        }
         if ( true === $this->group ) {
             $numbers = '0123456789';
+        } else {
+            $numbers = '0,1,2,3,4,5,6,7,8,9';
+        }

a-z-listing/trunk/classes/class-a-z-listing.php

-                      r1941011
+                      r2003543
                 $query = (array) $query;
+                if ( ( ! isset( $query['post_type'] ) || 'page' === $query['post_type'] ) &&
+                isset( $post ) && 'page' === $post->post_type &&
+                ! ( isset( $query['child_of'] ) || isset( $query['parent'] ) ) ) {
+                    $section       = self::get_section();
+                    $q['child_of'] = $section->ID;
+                if ( isset( $query['post_type'] ) ) {
+                    if ( is_array( $query['post_type'] ) && count( $query['post_type'] ) === 1 ) {
+                        $query['post_type'] = array_shift( $query['post_type'] );
+                    }
+                }
+                if ( ! isset( $query['post_parent'] ) && ! isset( $query['child_of'] ) ) {
+                    if ( isset( $query['post_type'] ) && isset( $post ) ) {
+                        if ( 'page' === $query['post_type'] && 'page' === $post->post_type ) {
+                            $section           = self::get_section();
+                            $query['child_of'] = $section->ID;
+                        }
+                    }
+                }
                 $query = wp_parse_args(
                     (array) $query,
+                    $query,
                     array(
                         'post_type'   => 'page',
 …
             if ( $query instanceof WP_Query ) {
+                $post_type = $query->post_type;
+            } else {
+                $post_type = $query['post_type'];
+            }
+            if ( 'page' === $post_type ) {
+                $items       = get_pages( $query );
+                $items       = $query->posts;
                 $this->query = $query;
             } else {
+                $wq          = new WP_Query( $query );
+                $items       = $wq->posts;
+                $this->query = $wq;
+                if ( isset( $query['child_of'] ) ) {
+                    $items       = get_pages( $query );
+                    $this->query = $query;
+                } else {
+                    $wq          = new WP_Query( $query );
+                    $items       = $wq->posts;
+                    $this->query = $wq;
+                }
+            }
 …
      */
     public static function mb_string_to_array( $string ) {
+        return array_map(
+            function ( $i ) use ( $string ) {
+                return mb_substr( $string, $i, 1 );
+            },
+            range( 0, mb_strlen( $string ) - 1 )
+        );
+        if ( extension_loaded( 'mbstring' ) ) {
+            return array_map(
+                function ( $i ) use ( $string ) {
+                    return mb_substr( $string, $i, 1 );
+                },
+                range( 0, mb_strlen( $string ) - 1 )
+            );
+        }
+        return explode( '', $string );
+    }
 …
         $others = apply_filters( 'a-z-listing-non-alpha-char', $others );
         $alphabet_groups = mb_split( ',', $alphabet );
+        $alphabet_groups = explode( ',', $alphabet );
         $letters         = array_reduce(
             $alphabet_groups,
 …
                             $index = $this->alphabet[ $index ];
                         } else {
                             $index = '_';
+                            $index = $this->unknown_letters;
+                        }
 …
+            }
             if ( ! empty( $index[ $this->unknown_letters ] ) ) {
+            if ( array_key_exists( $this->unknown_letters, $indexed_items ) && ! empty( $indexed_items[ $this->unknown_letters ] ) ) {
                 $this->alphabet_chars[] = $this->unknown_letters;
+            }
 …
     /**
      * Return the letter links HTML
+     * Retrieve the letter links HTML
+     *
      * @since 1.0.0
 …
     /**
-     * Load and execute a theme template
+     *
-     * @since 1.0.0
-     * @param string $template_file The path of the template to execute.
-     */
-    protected function do_template( $template_file ) {
-        $a_z_query = $this;
-        if ( ! empty( $template_file ) ) {
-            include $template_file;
+        }
+    }
-    /**
      * Print the index list HTML created by a theme template
+     *
 …
         $template = locate_template( array( 'a-z-listing-' . $section . '.php', 'a-z-listing.php' ) );
         if ( $template ) {
             $this->do_template( $template );
+            a_z_listing_do_template( $this, $template );
         } else {
             $this->do_template( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'templates' . DIRECTORY_SEPARATOR . 'a-z-listing.php' );
+            a_z_listing_do_template( $this, dirname( __FILE__ ) . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'templates' . DIRECTORY_SEPARATOR . 'a-z-listing.php' );
+        }
         wp_reset_postdata();
 …
     /**
      * Return the index list HTML created by a theme template
+     * Retrieve the index list HTML created by a theme template
+     *
      * @since 0.7
 …
     /**
      * Get the item object for the current post
+     * Retrieve the item object for the current post
+     *
      * @since 2.0.0
 …
      */
     public function get_the_item_object( $force = '' ) {
+        global $post;
         if ( 'I understand the issues!' === $force ) {
+            $item = explode( ':', $this->current_item['item'], 1 );
+            if ( isset( $item[1] ) ) {
+                if ( 'terms' === $this->type ) {
+                    return get_term( $item[1] );
+            $current_item = $this->current_item['item'];
+            if ( is_string( $current_item ) ) {
+                $item = explode( ':', $current_item, 2 );
+                if ( isset( $item[1] ) ) {
+                    if ( 'terms' === $this->type ) {
+                        return get_term( $item[1] );
+                    }
+                    $post = get_post( $item[1] );
+                    setup_postdata( $post );
+                    return $post;
+                }
+                global $post;
+                $post = get_post( $item[1] );
+            }
+            if ( is_a( $current_item, 'WP_Post' ) ) {
+                $post = $current_item;
                 setup_postdata( $post );
                 return $post;
+            }
+            return $current_item;
+        }
 …
     /**
+     * Returns the number of letters in the loaded alphabet
+     * Retrieve meta field for an item.
+     *
+     * @since 2.1.0
+     * @param string $key The meta key to retrieve. By default returns data for all keys.
+     * @param bool   $single Whether to return a single value.
+     * @return mixed Will be an array if $single is false. Will be value of meta data field if $single is true.
+     */
+    function get_item_meta( $key = '', $single = false ) {
+        if ( is_string( $this->current_item['item'] ) ) {
+            $item = explode( ':', $this->current_item['item'], 2 );
+            if ( 'term' === $type[0] ) {
+                return get_term_meta( $item[1], $key, $single );
+            }
+            return get_post_meta( $item[1], $key, $single );
+        }
+        if ( is_a( $this->current_item['item'], 'WP_Term' ) ) {
+            return get_term_meta( $this->current_item['item']->term_id, $key, $single );
+        }
+        return get_post_meta( $this->current_item['item']->ID, $key, $single );
+    }
+    /**
+     * Retrieve the number of letters in the loaded alphabet
+     *
      * @since 1.0.0
 …
     /**
      * Return the number of posts within the current letter
+     * Retrieve the number of posts within the current letter
+     *
      * @since 0.7
 …
     /**
      * Return the number of posts within the current letter
+     * Retrieve the number of posts within the current letter
+     *
      * @since 0.7
 …
     /**
      * Return the number of posts within the current letter
+     * Retrieve the number of posts within the current letter
+     *
      * @since 1.0.0
 …
     /**
      * Return the ID of the current letter. This is not escaped!
+     * Retrieve the ID of the current letter. This is not escaped!
+     *
      * @since 0.7
 …
     /**
      * Return the title of the current letter. For example, upper-case A or B or C etc. This is not escaped!
+     * Retrieve the title of the current letter. For example, upper-case A or B or C etc. This is not escaped!
+     *
      * @since 0.7
 …
     /**
      * Return the title of the current post. This is not escaped!
+     * Retrieve the title of the current post. This is not escaped!
+     *
      * @since 1.0.0
 …
     public function get_the_title() {
         $title = $this->current_item['title'];
+        $item  = $this->current_item['item'];
+        if ( $item instanceof WP_Post ) {
+            $title = apply_filters( 'the_title', $title, $item->ID );
+        } elseif ( $item instanceof WP_Term ) {
+            $title = apply_filters( 'term_name', $title, $item );
+        }
+        if ( is_string( $this->current_item['item'] ) ) {
+            $item = explode( ':', $this->current_item['item'], 2 );
+        } else {
+            $item = $this->current_item['item'];
+        }
+        if ( is_array( $item ) ) {
+            if ( 'post' === $item[0] ) {
+                return apply_filters( 'the_title', $title, $item[1] );
+            }
+            if ( 'term' === $item[0] ) {
+                return apply_filters( 'term_name', $title, $item[1] );
+            }
+        } else {
+            if ( is_a( $item, 'WP_Post' ) ) {
+                return apply_filters( 'the_title', $title, $item->ID );
+            }
+            if ( is_a( $item, 'WP_Term' ) ) {
+                return apply_filters( 'term_name', $title, $item->term_id );
+            }
+        }
         return $title;
+    }
 …
     /**
      * Return the permalink of the current post. This is not escaped!
+     * Retrieve the permalink of the current post. This is not escaped!
+     *
      * @since 1.0.0
 …
         return $this->current_item['link'];
+    }
+}
+/**
+ * Load and execute a theme template
+ *
+ * @since 2.1.0
+ * @param A_Z_Query $a_z_query The Query object.
+ * @param string    $template_file The path of the template to execute.
+ */
+function a_z_listing_do_template( $a_z_query, $template_file ) {
+    require $template_file;
+}

a-z-listing/trunk/css/a-z-listing-default.css

-                      r1940891
+                      r2003543
     height: 2em;
     box-sizing: border-box;
     margin: 0.15em;
+    margin: 0 0 0.6em;
     border: 2px solid #e5e5e5;
     background: #f5f5f5;
 …
     box-sizing: border-box;
     column-gap: 0.6em;
     column-width: 10em;
+    column-width: 15em;
     line-height: 1.6em; }
     .letter-section ul.columns li {
 …
     .letter-section ul.columns.max-0-columns, .letter-section ul.columns.max-1-columns {
       column-count: 1;
       max-width: 10.6em; }
+      max-width: 15.6em; }
     .letter-section ul.columns.max-2-columns {
       column-count: 2;
       max-width: 20.6em; }
+      max-width: 30.6em; }
     .letter-section ul.columns.max-3-columns {
       column-count: 3;
       max-width: 31.2em; }
+      max-width: 46.2em; }
     .letter-section ul.columns.max-4-columns {
       column-count: 4;
       max-width: 41.8em; }
+      max-width: 61.8em; }
     .letter-section ul.columns.max-5-columns {
       column-count: 5;
       max-width: 52.4em; }
+      max-width: 77.4em; }
     .letter-section ul.columns.max-6-columns {
       column-count: 6;
       max-width: 63em; }
+      max-width: 93em; }
     .letter-section ul.columns.max-7-columns {
       column-count: 7;
       max-width: 73.6em; }
+      max-width: 108.6em; }
     .letter-section ul.columns.max-8-columns {
       column-count: 8;
       max-width: 84.2em; }
+      max-width: 124.2em; }
     .letter-section ul.columns.max-9-columns {
       column-count: 9;
       max-width: 94.8em; }
+      max-width: 139.8em; }
     .letter-section ul.columns.max-10-columns {
       column-count: 10;
       max-width: 105.4em; }
+      max-width: 155.4em; }
     .letter-section ul.columns.max-11-columns {
       column-count: 11;
       max-width: 116em; }
+      max-width: 171em; }
     .letter-section ul.columns.max-12-columns {
       column-count: 12;
       max-width: 126.6em; }
+      max-width: 186.6em; }
     .letter-section ul.columns.max-13-columns {
       column-count: 13;
       max-width: 137.2em; }
+      max-width: 202.2em; }
     .letter-section ul.columns.max-14-columns {
       column-count: 14;
       max-width: 147.8em; }
+      max-width: 217.8em; }
     .letter-section ul.columns.max-15-columns {
       column-count: 15;
       max-width: 158.4em; }
+      max-width: 233.4em; }
   .letter-section div.back-to-top {
     width: 100%;

a-z-listing/trunk/css/a-z-listing-default.css.map

r1940891	r2003543
7	7	],
8	8	"names": [],
9		"mappings": "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"
	9	"mappings": "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"
10	10	}

a-z-listing/trunk/css/a-z-listing-default.scss

-                      r1940891
+                      r2003543
             height: 2em;
             box-sizing: border-box;
             margin: 0.15em;
+            margin: 0 0 0.6em;
             border: 2px solid #e5e5e5;
             background: #f5f5f5;
 …
         box-sizing: border-box;
         column-gap: 0.6em;
         column-width: 10em;
+        column-width: 15em;
         line-height: 1.6em;
         li {
 …
         &.max-1-columns {
             column-count: 1;
             max-width: 10.6em;
+            max-width: 15.6em;
+        }
         @for $column from 2 to 16 {
             &.max-#{$column}-columns {
                 column-count: $column;
                 max-width: ($column * 10em) + (($column - 1) * 0.6em);
+                max-width: ($column * 15em) + (($column - 1) * 0.6em);
+            }
+        }

a-z-listing/trunk/functions/enqueues.php

-                      r1939516
+                      r2003543
  */
 function a_z_listing_do_enqueue() {
+    wp_register_style( 'a-z-listing', plugins_url( 'css/a-z-listing-default.css', dirname( __FILE__ ) ), array( 'dashicons' ) );
+    wp_register_script( 'a-z-listing-tabs', plugins_url( 'js/a-z-listing-tabs.js', dirname( __FILE__ ) ), array( 'jquery', 'jquery-ui-tabs' ) );
+    wp_register_style(
+        'a-z-listing',
+        plugins_url( 'css/a-z-listing-default.css', dirname( __FILE__ ) ),
+        array( 'dashicons' )
+    );
+    wp_register_style(
+        'a-z-listing-admin',
+        plugins_url( 'css/a-z-listing-customize.css', dirname( __FILE__ ) ),
+        array()
+    );
+    wp_register_script(
+        'a-z-listing-tabs',
+        plugins_url( 'scripts/a-z-listing-tabs.js', dirname( __FILE__ ) ),
+        array(
+            'jquery',
+            'jquery-ui-tabs',
+        ),
+        false,
+        true
+    );
+    wp_register_script(
+        'a-z-listing-widget-admin',
+        plugins_url( 'scripts/a-z-listing-widget-admin.js', dirname( __FILE__ ) ),
+        array(
+            'jquery',
+            'jquery-ui-autocomplete',
+        ),
+        false,
+        true
+    );
     $add_styles = get_option( 'a-z-listing-add-styling', true );
 …
         add_action( 'wp_enqueue_scripts', 'a_z_listing_enqueue_styles' );
+    }
+    add_action( 'customize_controls_enqueue_scripts', 'a_z_listing_customize_enqueue_styles' );
     $tabify = get_option( 'a-z-listing-add-tabs', false );

a-z-listing/trunk/functions/helpers.php

-                      r1939419
+                      r2003543
 /**
  * Returns whether the query has any letters left
+ * Retrieve whether the query has any letters left
+ *
  * @since 0.7
 …
 /**
  * Returns whether the query has any posts left for the current letter
+ * Whether the query has any posts left for the current letter
+ *
  * @since 0.7
 …
 /**
  * Returns whether the query has any posts left for the current letter
+ * Whether the query has any posts left for the current letter
+ *
  * @since 0.8.0
 …
 /**
  * Returns the number of posts for the letter
+ * Retrieve the number of posts for the letter
+ *
  * @since 0.7
 …
 /**
  * Returns the number of posts for the letter
+ * Retrieve the number of posts for the letter
+ *
  * @since 0.7
 …
 /**
  * Returns the number of posts for the letter
+ * Retrieve the number of posts for the letter
+ *
  * @since 0.7
 …
 /**
  * Get the number of letters for the query
+ * Retrieve the number of letters for the query
+ *
  * @since 1.0.0
 …
 /**
  * Get the current letter ID
+ * Retrieve the current letter ID
+ *
  * @since 0.7
 …
 /**
  * Get the current letter title
+ * Retrieve the current letter title
+ *
  * @since 0.7
 …
 /**
  * Get the current item title
+ * Retrieve the current item title
+ *
  * @since 0.8.0
 …
 /**
  * Get the current item permalink
+ * Retrieve the current item permalink
+ *
  * @since 0.8.0
 …
 /**
  * Returns the A-Z Index page content
+ * Retrieve the A-Z Index page content
+ *
  * @since 0.1
 …
 /**
  * Returns the index of posts ordered and segmented alphabetically
+ * Retrieve the index of posts ordered and segmented alphabetically
+ *
  * @since 0.8.0
 …
 /**
  * Returns the A-Z Letter list
+ * Retrieve the A-Z Letter list
+ *
  * @since 0.7
 …
 /**
  * Returns the A-Z Letter list
+ * Retrieve the A-Z Letter list
+ *
  * @since 0.8.0
 …
     return a_z_listing_cache( $query, '', $use_cache )->get_the_letters( $target, $styling );
+}
+/**
+ * Check value for truthiness
+ *
+ * @since 2.1.0
+ * @param string|int|bool $value The value to check for thruthiness.
+ * @return bool The truthiness of the value.
+ */
+function a_z_listing_is_truthy( $value ) {
+    switch ( $value ) {
+        case '1':
+        case 'yes':
+        case 'true':
+        case 1:
+        case true:
+            return true;
+        default:
+            return false;
+    }
+}

a-z-listing/trunk/functions/scripts.php

-                      r1939419
+                      r2003543
     add_action( 'wp_enqueue_scripts', 'a_z_listing_force_enqueue_tabs' );
+}
+/**
+ * Enqueue the widget configuration support script
+ *
+ * @since 2.1.0
+ */
+function a_z_listing_enqueue_widget_admin_script() {
+    wp_enqueue_script( 'a-z-listing-widget-admin' );
+}

a-z-listing/trunk/functions/shortcode.php

-                      r1941011
+                      r2003543
  * @since 1.7.0 Add numbers attribute to append or prepend numerics to the listing.
  * @since 1.8.0 Fix numbers attribute when selecting to display terms. Add grouping to numbers via attribute. Add alphabet override via new attribute.
+ * @since 2.0.0 Add parent-term and hide-empty parameters.
  * @param  array $attributes Provided by WordPress core. Contains the shortcode attributes.
  * @return string The A-Z Listing HTML.
 …
             'alphabet'         => '',
             'display'          => 'posts',
+            'group-numbers'    => false,
+            'exclude-posts'    => '',
+            'exclude-terms'    => '',
+            'get-all-children' => 'false',
+            'group-numbers'    => '',
             'grouping'         => '',
+            'hide-empty-terms' => 'false',
             'numbers'          => 'hide',
+            'parent-post'      => '',
+            'parent-term'      => '',
             'post-type'        => 'page',
+            'exclude-posts'    => '',
+            'return'           => 'listing',
+            'target'           => '',
             'taxonomy'         => '',
             'terms'            => '',
-            'exclude-terms'    => '',
-            'hide-empty-terms' => false,
-            'parent-term'      => '',
-            'return'           => 'listing',
-            'target'           => '',
         ),
         $attributes,
 …
     $grouping      = $attributes['grouping'];
     $group_numbers = false;
+    if ( ! empty( $attributes['group-numbers'] ) && a_z_listing_is_truthy( $attributes['group-numbers'] ) ) {
+        $group_numbers = true;
+    }
     if ( 'numbers' === $grouping ) {
         $group_numbers = true;
 …
     } else {
         $grouping = intval( $grouping );
         if ( 1 < $grouping ) {
+        if ( 1 < $grouping && empty( $attributes['group-numbers'] ) ) {
             $group_numbers = true;
+        }
+    }
-    if ( true === $attributes['group-numbers'] ) {
-        $group_numbers = true;
+    }
     $grouping_obj = new A_Z_Listing_Grouping( $grouping );
+    $numbers_obj = null;
+    if ( ! empty( $attributes['numbers'] ) && 'hide' !== $attributes['numbers'] ) {
+        $numbers_obj = add_a_z_numbers( $attributes['numbers'], $group_numbers );
+    }
+    $numbers_obj  = new A_Z_Listing_Numbers( $attributes['numbers'], $group_numbers );
     if ( 'terms' === $attributes['display'] && ! empty( $attributes['taxonomy'] ) ) {
         $taxonomy = '' !== $attributes['taxonomy'] ? $attributes['taxonomy'] : 'category';
         $query    = array(
+            'taxonomy' => $taxonomy,
+            'taxonomy'   => $taxonomy,
+            'hide_empty' => isset( $attributes['hide_empty'] ) && a_z_listing_is_truthy( $attributes['hide-empty'] ),
         );
 …
         if ( ! empty( $terms_string ) ) {
             $terms = mb_split( ',', $terms_string );
+            $terms = explode( ',', $terms_string );
             $terms = array_map( 'trim', $terms );
             $terms = array_map( 'intval', $terms );
 …
         if ( ! empty( $attributes['hide-empty-terms'] ) ) {
+            $hide_empty = false;
+            if ( 'true' === $attributes['hide-empty-terms'] || '1' === $attributes['hide-empty-terms'] ) {
+                $hide_empty = true;
+            }
+            $hide_empty = a_z_listing_is_truthy( $attributes['hide-empty-terms'] );
             $query = wp_parse_args(
                 $query,
 …
         $a_z_query = new A_Z_Listing( $query, 'terms' );
     } else {
+        $post_type = explode( ',', $attributes['post-type'] );
+        $post_type = array_map( 'trim', $post_type );
         $query = array(
             'post_type' => $attributes['post-type'],
+            'post_type' => $post_type,
         );
         if ( ! empty( $attributes['exclude-posts'] ) ) {
             $exclude_posts = mb_split( ',', $attributes['exclude-posts'] );
+            $exclude_posts = explode( ',', $attributes['exclude-posts'] );
             $exclude_posts = array_map( 'trim', $exclude_posts );
             $exclude_posts = array_map( 'intval', $exclude_posts );
 …
             if ( ! empty( $exclude_posts ) ) {
+                $query = wp_parse_args(
+                    $query,
+                    array(
+                        'post__not_in' => $exclude_posts,
+                    )
+                );
+                $query = wp_parse_args( $query, array( 'post__not_in' => $exclude_posts ) );
+            }
+        }
+        if ( ! empty( $attributes['parent-post'] ) ) {
+            if ( a_z_listing_is_truthy( $attributes['get-all-children'] ) ) {
+                $child_query = array( 'child_of' => $attributes['parent-post'] );
+            } else {
+                $child_query = array( 'post_parent' => $attributes['parent-post'] );
+            }
+            $query = wp_parse_args( $query, $child_query );
+        }
+        $taxonomy  = '' !== $attributes['taxonomy'] ? $attributes['taxonomy'] : 'category';
+        $tax_query = array();
         if ( ! empty( $attributes['terms'] ) ) {
+            $taxonomy = '' !== $attributes['taxonomy'] ? $attributes['taxonomy'] : 'category';
+            $terms    = mb_split( ',', $attributes['terms'] );
+            $terms    = array_map( 'trim', $terms );
+            $terms    = array_filter(
+            $terms = explode( ',', $attributes['terms'] );
+            $terms = array_map( 'trim', $terms );
+            $terms = array_filter(
                 $terms,
                 function( $value ) {
 …
+                }
             );
+            $terms    = array_unique( $terms );
+            $query = wp_parse_args(
+                $query,
+                array(
+                    'tax_query' => array(
+                        array(
+                            'taxonomy' => $taxonomy,
+                            'field'    => 'slug',
+                            'terms'    => $terms,
+                        ),
+                    ),
+                )
+            );
+            $terms = array_unique( $terms );
+            $tax_query[] = array(
+                'taxonomy' => $taxonomy,
+                'field'    => 'slug',
+                'terms'    => $terms,
+                'operator' => 'IN',
+            );
+        }
+        if ( ! empty( $attributes['exclude-terms'] ) ) {
+            $ex_terms = explode( ',', $attributes['exclude-termsterms'] );
+            $ex_terms = array_map( 'trim', $terms );
+            $ex_terms = array_filter(
+                $ex_terms,
+                function( $value ) {
+                    return ! empty( $value );
+                }
+            );
+            $ex_terms = array_unique( $ex_terms );
+            $tax_query[] = array(
+                'taxonomy' => $taxonomy,
+                'field'    => 'slug',
+                'terms'    => $ex_terms,
+                'operator' => 'NOT IN',
+            );
+        }
+        if ( ! empty( $tax_query ) ) {
+            $query['tax_query'] = $tax_query;
+        }
 …
     $grouping_obj->teardown();
+    if ( null != $numbers_obj ) {
+        $numbers_obj->teardown();
+    }
+    $numbers_obj->teardown();
     return $ret;

a-z-listing/trunk/functions/styles.php

-                      r1939419
+                      r2003543
 function a_z_listing_enqueue_styles( $force = false ) {
     global $post;
     if ( $force || is_active_widget( false, false, 'bh_az_widget', true ) || ( is_singular() && has_shortcode( $post->post_content, 'a-z-listing' ) ) ) {
+    if ( $force || is_customize_preview() || is_active_widget( false, false, 'bh_az_widget', true ) || ( is_singular() && has_shortcode( $post->post_content, 'a-z-listing' ) ) ) {
         wp_enqueue_style( 'a-z-listing' );
+    }
+}
+/**
+ * Enqueue A-Z customizer styles.
+ *
+ * @since 2.1.0
+ */
+function a_z_listing_customize_enqueue_styles() {
+    wp_enqueue_style( 'a-z-listing-admin' );
+}

a-z-listing/trunk/languages/a-z-listing.pot

-                      r1942709
+                      r2003543
 msgid ""
 msgstr ""
 "Project-Id-Version: A-Z Listing 2.0.6\n"
+"Project-Id-Version: A-Z Listing 2.1.0\n"
 "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/a-z-listing\n"
 "POT-Creation-Date: 2018-09-17 00:28:41+00:00\n"
+"POT-Creation-Date: 2018-12-28 14:28:39+00:00\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 …
 "X-Generator: grunt-wp-i18n1.0.2\n"
 #: classes/class-a-z-listing.php:318
+#: classes/class-a-z-listing.php:328
 #. translators: List the aphabet of your language in the order that your
 #. language prefers. list as groups of identical meanings but different
 …
 msgstr ""
 #: classes/class-a-z-listing.php:320
+#: classes/class-a-z-listing.php:330
 #. translators: This should be a single character to denote "all entries that
 #. didn't fit under one of the alphabet character groups defined". This is used
 …
 msgstr ""
 #: templates/a-z-listing.example.php:45 templates/a-z-listing.php:52
+#: templates/a-z-listing.example.php:45 templates/a-z-listing.php:67
 msgid "Back to top"
 msgstr ""
 #: templates/a-z-listing.example.php:53 templates/a-z-listing.php:62
+#: templates/a-z-listing.example.php:53 templates/a-z-listing.php:81
 msgid "There are no posts included in this index."
 msgstr ""
 …
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:29
+#: widgets/class-a-z-listing-widget.php:30
 msgid "Alphabetised links to the A-Z site map"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:110
 #: widgets/class-a-z-listing-widget.php:115
+#: widgets/class-a-z-listing-widget.php:125
+#: widgets/class-a-z-listing-widget.php:130
 msgid "Widget Title"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:119
+#: widgets/class-a-z-listing-widget.php:134
 msgid ""
 "Leave the title field blank, above, to use the title from the page set in "
 …
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:126
 msgid "Site map A-Z page"
+#: widgets/class-a-z-listing-widget.php:141
+msgid "Sitemap A-Z page"
 msgstr ""
+#: widgets/class-a-z-listing-widget.php:142
+#: widgets/class-a-z-listing-widget.php:153
+msgid ""
+"Type some or all of the title of the page you want links to point at. "
+"Ensure this input field is not selected when you save the settings."
+msgstr ""
+#: widgets/class-a-z-listing-widget.php:154
+#: widgets/class-a-z-listing-widget.php:214
+msgid ""
+"Matching posts will be shown as you type. Click on the correct post from "
+"the matches to update the setting."
+msgstr ""
+#: widgets/class-a-z-listing-widget.php:161
 msgid "Display posts or terms?"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:149
+#: widgets/class-a-z-listing-widget.php:168
 msgid "Posts"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:153
+#: widgets/class-a-z-listing-widget.php:172
 msgid "Taxonomy terms"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:163
+#: widgets/class-a-z-listing-widget.php:181
 msgid "Post-type to display"
 msgstr ""
+#: widgets/class-a-z-listing-widget.php:183
+#: widgets/class-a-z-listing-widget.php:200
+msgid "Show only children of this post (ID)"
+msgstr ""
+#: widgets/class-a-z-listing-widget.php:213
+msgid ""
+"Type some or all of the title of the post to limit the listing to only the "
+"children of that post. Ensure this input field is not selected when you "
+"save the settings."
+msgstr ""
+#: widgets/class-a-z-listing-widget.php:218
+msgid "Include grand-children?"
+msgstr ""
+#: widgets/class-a-z-listing-widget.php:230
 msgid "Taxonomy to display"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:203
+#: widgets/class-a-z-listing-widget.php:249
 msgid "Parent term to display children of"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:215
+#: widgets/class-a-z-listing-widget.php:261
 msgid "Terms to include (IDs)"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:228
+#: widgets/class-a-z-listing-widget.php:273
 msgid "Terms to exclude (IDs)"
 msgstr ""
 #: widgets/class-a-z-listing-widget.php:241
+#: widgets/class-a-z-listing-widget.php:285
 msgid "Hide empty terms"
 msgstr ""

a-z-listing/trunk/package-lock.json

-                      r1939419
+                      r2003543
     },
     "sprintf-js": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.1.tgz",
       "integrity": "sha1-Nr54Mgr+WAH2zqPueLblqrlA6gw=",
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.2.tgz",
+      "integrity": "sha512-VE0SOVEHCk7Qc8ulkWw3ntAzXuqf7S2lvwQaDLRnUeIEaKNQJzV6BwmLKhOqT61aGhfUMrXeaBk+oDGCzvhcug==",
       "dev": true
     },
 …
     },
     "underscore.string": {
       "version": "3.3.4",
       "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-3.3.4.tgz",
       "integrity": "sha1-LCo/n4PmR2L9xF5s6sZRQoZCE9s=",
+      "version": "3.3.5",
+      "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-3.3.5.tgz",
+      "integrity": "sha512-g+dpmgn+XBneLmXXo+sGlW5xQEt4ErkS3mgeN2GFbremYeMBSJKr9Wf2KJplQVaiPY/f7FN6atosWYNm9ovrYg==",
       "dev": true,
       "requires": {

a-z-listing/trunk/readme.txt

-                      r1991923
+                      r2003543
 Requires PHP: 5.6
 Tested up to: 5.0
 Stable tag: 2.0.4
+Stable tag: 2.1.0
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 …
 = How do I show posts of a different post-type (not pages) or multiple post-types (e.g. posts AND pages) =
 This can be achieved using the shortcode or PHP.
+This can be achieved using the shortcode or PHP. In these examples the generic phrase `post-type-slug` is used to describe the concept. The default post types provided by WordPress are called "Posts" and "Pages". Their slugs are `post` and `page` respectively. You need to use these names in place of the examples (i.e. `your-post-type-slug`, `type1-slug`, and `type1-slug`).
 **Shortcode method**
 …
+`
 The argument to `the_a_z_listing()` is an [array](http://php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
+The argument to `the_a_z_listing()` is an [array](https://secure.php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
 The code above needs to be within a php block which is denoted by the `<?php` and `?>` pair. Depending on your theme, you might not need the opening and closing php tags shown in the above snippet; if that is the case, you are free to omit them in your code.
 …
 = How do I show posts from a specific category only =
 This can be achieved using the shortcode or PHP.
+This can be achieved using the shortcode or PHP. In these examples the generic phrase `taxonomy` and `term` are used to describe the concept. The default taxonomies provided by WordPress are called "Categories" and "Tags". Their slugs are `category` and `post_tag` respectively. Each Category and Tag are then known as "terms". You need to use the slug for each individual category or tag in place of the example slugs (i.e. `term-slug`, `term1-slug`, and `term1-slug`).
 **Shortcode method**
 …
+`
 Any number of terms may be added to the `terms` [array](http://php.net/manual/en/language.types.array.php), including one or none.
 The argument to `the_a_z_listing()` is an [array](http://php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
+Any number of terms may be added to the `terms` [array](https://secure.php.net/manual/en/language.types.array.php), including one or none.
+The argument to `the_a_z_listing()` is an [array](https://secure.php.net/manual/en/language.types.array.php) and takes the same parameters as [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
 The code above needs to be within a php block which is denoted by the `<?php` and `?>` pair. Depending on your theme, you might not need the opening and closing php tags shown in the above snippet; if that is the case, you are free to omit them in your code.
 …
 = How do I show terms from a taxonomy instead of posts =
 This can be achieved using the shortcode or PHP.
+This can be achieved using the shortcode or PHP. In these examples the generic phrase `taxonomy` and `term` are used to describe the concept. The default taxonomies provided by WordPress are called "Categories" and "Tags". Their slugs are `category` and `post_tag` respectively. You need to use the slug for the taxonomy in place of the example slugs (i.e. `taxonomy-slug`).
 **Shortcode method**
 …
+`
 The argument to `the_a_z_listing()` is a [string](http://php.net/manual/en/language.types.string.php) and contains the slug of a single taxonomy, e.g. `category` or `post_tag`.
+The argument to `the_a_z_listing()` is a [string](https://secure.php.net/manual/en/language.types.string.php) and contains the slug of a single taxonomy, e.g. `category` or `post_tag`.
 The code above needs to be within a php block which is denoted by the `<?php` and `?>` pair. Depending on your theme, you might not need the opening and closing php tags shown in the above snippet; if that is the case, you are free to omit them in your code.
 …
+`
 <?php
 add_action( 'wp', 'a_z_listing_force_enable_styles', 99 );
+add_action( 'init', 'a_z_listing_force_enable_styles', 99 );
 ?>
+`
 …
+`
 <?php
 add_action( 'wp', 'your_override_wrapper_function', 99 );
+add_action( 'init', 'your_override_wrapper_function', 99 );
 function your_override_wrapper_function() {
     if ( ! is_page( 'your-a-z-listing-page-slug-or-ID' ) ) { // ID is numeric, slug is a string.
 …
 == Changelog ==
+= 2.1.0 =
+**Bug Fixes:**
+* Fix widget configuration autocomplete fields for target post and parent post in the theme customizer
+* Fix taxonomy-term-filtered listings displaying all posts (e.g. shortcodes of the form `[a-z-listing taxonomy="category" terms="term"])
+* Fix `get_the_item_object()` to work with old-style overridden indices
+* Fix `get_the_item_object()` to correctly extract the item ID and load the correct item
+* Improve javascript on the widget configuration
+* Clarified the examples with explanations about "post types", "taxonomies", and "terms" to explain what each of these mean.
+**New Features:**
+* Add parent-page attribute to the shortcode
+* Add simpler and safer filter for overriding the index letter for an item
+* Add simpler and safer filter for overriding the title for an item
+* Add new function for fetching meta data in a template: `$a_z_listing->get_item_meta()`
+* Allow exclude-terms to be used with display="posts"
+* Moved template loading function outside of the `A_Z_Query` class to prevent accidental access to the plugin internal structure
 = 2.0.6 =
-* *Personal Note:* Sorry to everyone who upgraded to 2.0.0 thru to 2.0.5 about yet another update. I have failed you all by shipping faulty versions to you, and I'm sorry, especially so that you've had to endure so many updates the past few days.
 * Fix widget target post support
 * Fix filtering posts by multiple taxonomy terms
 …
 * Fix javascript error on widgets screen
+*2.0.0 also introduced the following changes:*
+= 2.0.0 =
 * Improved widget configuration.
 …
 * Fix the stylesheet to better cope with variances in font-size and text length in the alphabet links list and widget.
 * Introduce PHP classes for adding numbers and grouping to the alphabet. Allows unhooking from the filters to undo the changes, where previously you could not unhook these modifications once they'd been applied.
+* **BREAKING CHANGES:**
+  * Multi column example:
+    If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+    If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+    If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+  * Template customisations:
+    If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+    If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+    To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+    **The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.**
+    *This step is purposely omitted to save memory and try to improve performance.*
+= 2.0.0 =
+* Improved widget configuration.
+* New attribute added to the shortcode when `display="posts"`:
+  * `exclude-posts`: remove specific posts from the list
+* New attributes added to the shortcode when `display="terms"`:
+  * `exclude-terms`: sets the terms to exclude from display
+  * `parent-term`: set the parent that all displayed terms must be organised under
+  * `hide-empty-terms`: hide terms that have no posts associated
+* Fix the stylesheet to better cope with variances in font-size and text length in the alphabet links list and widget.
+* Introduce PHP classes for adding numbers and grouping to the alphabet. Allows unhooking from the filters to undo the changes, where previously you could not unhook these modifications once they'd been applied.
+* **BREAKING CHANGES:**
+  * Multi column example:
+    If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+    If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+    If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+  * Template customisations:
+    If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+    If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+    To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+    **The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.**
+    *This step is purposely omitted to save memory and try to improve performance.*
+= 1.9.2 =
+Bugfix:
+* Fix using multiple terms in the shortcode only displays results for the first term
+= 1.9.1 =
+Feature Request:
+Add CSS classes to letters indicating presence of posts or not:
+* `has-posts` allows styling of letters that have posts visible in the listing
+* `no-posts` allows styling of letters that do not have any posts visible in the listing
+You can use these classes to hide letters that have no posts by including the following CSS rule:
+`.az-letters ul.az-links li.no-posts {
+    display: none;
+}`
+= 1.9.0 =
+* Fix multi-column example template
+* Update multi-column styles to include display:grid support
+* Add back-to-top link
+* Add server system requirements to readme
+* Add PHP section to readme including link to API Reference
+**BREAKING CHANGES:**
+*Multi column example:*
+* If you have copied the multi-column example in previous releases to your theme folder then you will need to perform some manual steps.
+* If you have not edited the file, just delete it and the new template from the plugin will take control and perform the same functionality.
+* If you have modified the example template then you will need to compare with the file in the plugin at `templates/a-z-listing.php` and merge any changes into your template.
+*Template customisations:*
+* If you have customised the in-built templates or written your own then you may experience breakage due to the post object not being loaded automatically.
+* If you require the template to access more than the post title and URL then you will need to add an additional call after `the_item()` to load the full `WP_Post` object into memory.
+* To load the post object you need to call `$a_z_query->get_the_item_object( 'I understand the issues!' );`.
+  __The argument must read exactly as written here to confirm that you understand that this might cause slowness or memory usage problems.__
+  _This step is purposely omitted to save memory and try to improve performance._
 = Previous =

a-z-listing/trunk/scripts/a-z-listing-tabs.js

-                      r1939419
+                      r2003543
 // props to @claytonchase (https://profiles.wordpress.org/claytonchase)
 jQuery( document ).ready( function() {
+    jQuery( "#az-tabs" ).tabs();
+    const tabs = document.getElementById( 'az-tabs' );
+    if ( tabs ) {
+        let link;
+        const letters = tabs.getElementById( 'letters' );
+        if ( letters ) {
+            link = letters.querySelector( `a[href="${window.location.hash}"]` );
+        }
+        if ( window.location.hash && link ) {
+            const activeTab = jQuery( link ).parent().index();
+            jQuery( tabs ).tabs( { active: activeTab } );
+        } else {
+            jQuery( tabs ).tabs();
+        }
+    }
 } );

a-z-listing/trunk/templates/a-z-listing.example.php

-                      r1939419
+                      r2003543
 ?>
 <div id="az-tabs">
+<div id="letters">
+    <div class="az-letters">
+        <?php $a_z_query->the_letters(); ?>
+    <div id="letters">
+        <div class="az-letters">
+            <?php $a_z_query->the_letters(); ?>
+        </div>
     </div>
+</div>
+<?php if ( $a_z_query->have_letters() ) : ?>
+<div id="az-slider">
+    <div id="inner-slider">
+        <?php
+        while ( $a_z_query->have_letters() ) :
+            $a_z_query->the_letter();
+            ?>
+            <?php if ( $a_z_query->have_items() ) : ?>
+                <div class="letter-section" id="<?php $a_z_query->the_letter_id(); ?>">
+                    <h2 class="letter-title">
+                        <span><?php $a_z_query->the_letter_title(); ?></span>
+                    </h2>
+    <?php if ( $a_z_query->have_letters() ) : ?>
+    <div id="az-slider">
+        <div id="inner-slider">
+            <?php
+            while ( $a_z_query->have_letters() ) :
+                $a_z_query->the_letter();
+                ?>
+                <?php if ( $a_z_query->have_items() ) : ?>
+                    <div class="letter-section" id="<?php $a_z_query->the_letter_id(); ?>">
+                        <h2 class="letter-title">
+                            <span><?php $a_z_query->the_letter_title(); ?></span>
+                        </h2>
                     <ul>
                         <?php
                         while ( $a_z_query->have_items() ) :
                             $a_z_query->the_item();
                             ?>
                             <li>
                                 <a href="<?php $a_z_query->the_permalink(); ?>"><?php $a_z_query->the_title(); ?></a>
                             </li>
                         <?php endwhile; ?>
                     </ul>
+                        <ul>
+                            <?php
+                            while ( $a_z_query->have_items() ) :
+                                $a_z_query->the_item();
+                                ?>
+                                <li>
+                                    <a href="<?php $a_z_query->the_permalink(); ?>"><?php $a_z_query->the_title(); ?></a>
+                                </li>
+                            <?php endwhile; ?>
+                        </ul>
+                    <div class="back-to-top"><a href="#letters"><?php _e( 'Back to top', 'a-z-listing' ); ?></a></div>
+                </div>
+            <?php endif; ?>
+        <?php endwhile; ?>
+                        <div class="back-to-top"><a href="#letters"><?php _e( 'Back to top', 'a-z-listing' ); ?></a></div>
+                    </div>
+                <?php endif; ?>
+            <?php endwhile; ?>
+        </div>
     </div>
-</div>
 </div>
 <?php else : ?>

a-z-listing/trunk/templates/a-z-listing.php

-                      r1939419
+                      r2003543
  * Default multicolumn template for the A-Z Listing plugin
+ *
  * This template will be given the variable `$a_z_query` which is an instance of
  * `A_Z_Listing`.
+ * This template will be given the variable `$a_z_query` which is an instance
+ * of `A_Z_Listing`.
+ *
  * You can override this template by copying this file into your theme
 …
  */
+$_a_z_listing_colcount  = 3;
+/**
+ * This value indicates the number of posts to require before a second column
+ * is created. However, due to the design of web browsers, the posts will flow
+ * evenly between the available columns. E.g. if you have 11 items, a value of
+ * 10 here will create two columns with 6 items in the first column and 5 items
+ * in the second column.
+ */
 $_a_z_listing_minpercol = 10;
 ?>
 <div id="az-tabs">
+<div id="letters">
+    <div class="az-letters">
+        <?php $a_z_query->the_letters(); ?>
+    <div id="letters">
+        <div class="az-letters">
+            <?php $a_z_query->the_letters(); ?>
+        </div>
+    </div>
+    <?php if ( $a_z_query->have_letters() ) : ?>
+    <div id="az-slider">
+        <div id="inner-slider">
+            <?php
+            while ( $a_z_query->have_letters() ) :
+                $a_z_query->the_letter();
+                ?>
+                <?php if ( $a_z_query->have_items() ) : ?>
+                    <?php
+                    $item_count  = $a_z_query->get_the_letter_count();
+                    $num_columns = ceil(
+                        $item_count / $_a_z_listing_minpercol
+                    );
+                    ?>
+                    <div class="letter-section"
+                        id="<?php $a_z_query->the_letter_id(); ?>">
+                        <h2 class="letter-title">
+                            <span>
+                                <?php $a_z_query->the_letter_title(); ?>
+                            </span>
+                        </h2>
+                        <?php $column_class = "max-$num_columns-columns"; ?>
+                        <ul class="columns <?php echo $column_class; ?>">
+                            <?php
+                            while ( $a_z_query->have_items() ) :
+                                $a_z_query->the_item();
+                                ?>
+                                <li>
+                                    <a href="
+                                        <?php $a_z_query->the_permalink(); ?>
+                                    ">
+                                        <?php $a_z_query->the_title(); ?>
+                                    </a>
+                                </li>
+                            <?php endwhile; ?>
+                        </ul>
+                        <div class="back-to-top">
+                            <a href="#letters">
+                                <?php _e( 'Back to top', 'a-z-listing' ); ?>
+                            </a>
+                        </div>
+                    </div>
+                    <?php
+                endif;
+            endwhile;
+            ?>
+        </div>
     </div>
 </div>
+<?php if ( $a_z_query->have_letters() ) : ?>
+<div id="az-slider">
+    <div id="inner-slider">
+<?php else : ?>
+    <p>
         <?php
+        while ( $a_z_query->have_letters() ) :
+            $a_z_query->the_letter();
+            ?>
+            <?php if ( $a_z_query->have_items() ) : ?>
+                <?php
+                $item_count   = $a_z_query->get_the_letter_count();
+                $column_limit = round( $item_count / $_a_z_listing_minpercol );
+                if ( $column_limit > $_a_z_listing_colcount ) {
+                    $column_limit = $_a_z_listing_colcount;
+                }
+                ?>
+                <div class="letter-section" id="<?php $a_z_query->the_letter_id(); ?>">
+                    <h2 class="letter-title">
+                        <span><?php $a_z_query->the_letter_title(); ?></span>
+                    </h2>
+                    <ul class="columns max-<?php echo $column_limit; ?>-columns">
+                        <?php
+                        while ( $a_z_query->have_items() ) :
+                            $a_z_query->the_item();
+                            ?>
+                            <li>
+                                <a href="<?php $a_z_query->the_permalink(); ?>"><?php $a_z_query->the_title(); ?></a>
+                            </li>
+                        <?php endwhile; ?>
+                    </ul>
+                    <div class="back-to-top"><a href="#letters"><?php _e( 'Back to top', 'a-z-listing' ); ?></a></div>
+                </div>
+                <?php
+            endif;
+        endwhile;
+        esc_html_e(
+            'There are no posts included in this index.',
+            'a-z-listing'
+        );
         ?>
+    </div>
+</div>
+</div>
+<?php else : ?>
+    <p><?php esc_html_e( 'There are no posts included in this index.', 'a-z-listing' ); ?></p>
+    </p>
     <?php
 endif;

a-z-listing/trunk/widgets/class-a-z-listing-widget.php

-                      r1942709
+                      r2003543
         );
+        add_action( 'admin_enqueue_scripts', 'a_z_listing_enqueue_widget_admin_script' );
         if ( is_active_widget( false, false, $this->id_base, true ) ) {
             a_z_listing_do_enqueue();
 …
         $public_taxonomies = get_taxonomies( $args, 'objects' );
         $widget_title      = $instance['title'];
+        $widget_title      = isset( $instance['title'] ) ? $instance['title'] : '';
         $widget_title_id   = $this->get_field_id( 'title' );
         $widget_title_name = $this->get_field_name( 'title' );
         $display_type      = $instance['type'];
+        $display_type      = ( 'terms' === $instance['type'] ) ? 'terms' : 'posts';
         $display_type_id   = $this->get_field_id( 'type' );
         $display_type_name = $this->get_field_name( 'type' );
         $target_post            = isset( $instance['post'] ) ? $instance['post'] : ( isset( $instance['page'] ) ? $instance['page'] : 0 );
+        $target_post            = isset( $instance['post'] ) ? intval( $instance['post'] ) : ( isset( $instance['page'] ) ? intval( $instance['page'] ) : 0 );
         $target_post_id         = $this->get_field_id( 'post' );
         $target_post_name       = $this->get_field_name( 'post' );
         $target_post_title      = ( $target_post > 0 ) ? get_the_title( $target_post ) : '';
+        $target_post_title      = isset( $instance['target_post'] ) ? $instance['target_post'] : ( 0 < $target_post ) ? get_the_title( $target_post ) : '';
         $target_post_title_id   = $this->get_field_id( 'target_post_title' );
         $target_post_title_name = $this->get_field_name( 'target_post_title' );
+        $listing_post_type            = isset( $instance['post_type'] ) ? $instance['post_type'] : 'page';
+        $listing_post_type_id         = $this->get_field_id( 'post_type' );
+        $listing_post_type_name       = $this->get_field_name( 'post_type' );
+        $listing_post_type_wrapper_id = $this->get_field_id( 'post_type_wrapper' );
+        $listing_taxonomy            = isset( $instance['taxonomy'] ) ? $instance['taxonomy'] : 'page';
+        $listing_taxonomy_id         = $this->get_field_id( 'taxonomy' );
+        $listing_taxonomy_name       = $this->get_field_name( 'taxonomy' );
+        $listing_taxonomy_wrapper_id = $this->get_field_id( 'taxonomy_wrapper' );
+        $listing_parent_term            = isset( $instance['parent_term'] ) ? $instance['parent_term'] : '';
+        $listing_parent_term_id         = $this->get_field_id( 'parent_term' );
+        $listing_parent_term_name       = $this->get_field_name( 'parent_term' );
+        $listing_parent_term_wrapper_id = $this->get_field_id( 'parent_term_wrapper' );
+        $listing_post_type      = isset( $instance['post_type'] ) ? $instance['post_type'] : 'page';
+        $listing_post_type_id   = $this->get_field_id( 'post_type' );
+        $listing_post_type_name = $this->get_field_name( 'post_type' );
+        $listing_parent_post            = isset( $instance['parent_post'] ) ? $instance['parent_post'] : '';
+        $listing_parent_post_id         = $this->get_field_id( 'parent_post' );
+        $listing_parent_post_name       = $this->get_field_name( 'parent_post' );
+        $listing_parent_post_title      = isset( $instance['parent_post_title'] ) ? $instance['parent_post_title'] : ( 0 < $listing_parent_post ) ? get_the_title( $listing_parent_post ) : '';
+        $listing_parent_post_title_id   = $this->get_field_id( 'parent_post_title' );
+        $listing_parent_post_title_name = $this->get_field_name( 'parent_post_title' );
+        $listing_all_children      = isset( $instance['all_children'] ) ? $instance['all_children'] : 'true';
+        $listing_all_children_id   = $this->get_field_id( 'all_children' );
+        $listing_all_children_name = $this->get_field_name( 'all_children' );
+        $listing_taxonomy      = isset( $instance['taxonomy'] ) ? $instance['taxonomy'] : 'page';
+        $listing_taxonomy_id   = $this->get_field_id( 'taxonomy' );
+        $listing_taxonomy_name = $this->get_field_name( 'taxonomy' );
+        $listing_parent_term      = isset( $instance['parent_term'] ) ? $instance['parent_term'] : '';
+        $listing_parent_term_id   = $this->get_field_id( 'parent_term' );
+        $listing_parent_term_name = $this->get_field_name( 'parent_term' );
         $listing_terms_include      = isset( $instance['terms'] ) ? $instance['terms'] : '';
 …
         $listing_terms_include_name = $this->get_field_name( 'terms' );
+        $listing_terms_exclude            = isset( $instance['terms_exclude'] ) ? $instance['terms_exclude'] : '';
+        $listing_terms_exclude_id         = $this->get_field_id( 'terms_exclude' );
+        $listing_terms_exclude_name       = $this->get_field_name( 'terms_exclude' );
+        $listing_terms_exclude_wrapper_id = $this->get_field_id( 'terms_exclude_wrapper' );
+        $listing_hide_empty_terms            = isset( $instance['hide_empty_terms'] ) ? $instance['hide_empty_terms'] : '';
+        $listing_hide_empty_terms_id         = $this->get_field_id( 'hide_empty_terms' );
+        $listing_hide_empty_terms_name       = $this->get_field_name( 'hide_empty_terms' );
+        $listing_hide_empty_terms_wrapper_id = $this->get_field_id( 'hide_empty_terms_wrapper' );
+        $listing_terms_exclude      = isset( $instance['terms_exclude'] ) ? $instance['terms_exclude'] : '';
+        $listing_terms_exclude_id   = $this->get_field_id( 'terms_exclude' );
+        $listing_terms_exclude_name = $this->get_field_name( 'terms_exclude' );
+        $listing_hide_empty_terms      = isset( $instance['hide_empty_terms'] ) ? $instance['hide_empty_terms'] : '';
+        $listing_hide_empty_terms_id   = $this->get_field_id( 'hide_empty_terms' );
+        $listing_hide_empty_terms_name = $this->get_field_name( 'hide_empty_terms' );
         ?>
+        <div>
+            <p>
+                <label for="<?php echo esc_attr( $widget_title_id ); ?>">
+                    <?php esc_html_e( 'Widget Title', 'a-z-listing' ); ?>
+                </label>
+                <input class="widefat" type="text"
+                    id="<?php echo esc_attr( $widget_title_id ); ?>"
+                    name="<?php echo esc_attr( $widget_title_name ); ?>"
+                    placeholder="<?php esc_attr_e( 'Widget Title', 'a-z-listing' ); ?>"
+                    value="<?php echo esc_attr( $widget_title ); ?>" />
+            </p>
+            <p style="color: #333;">
+                <?php esc_html_e( 'Leave the title field blank, above, to use the title from the page set in the next field', 'a-z-listing' ); ?>
+            </p>
+        <div class="a-z-listing-widget">
+            <div class="a-z-listing-widget-title-wrapper">
+                <p>
+                    <label for="<?php echo esc_attr( $widget_title_id ); ?>">
+                        <?php esc_html_e( 'Widget Title', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="text" class="widefat a-z-listing-title"
+                        id="<?php echo esc_attr( $widget_title_id ); ?>"
+                        name="<?php echo esc_attr( $widget_title_name ); ?>"
+                        placeholder="<?php esc_attr_e( 'Widget Title', 'a-z-listing' ); ?>"
+                        value="<?php echo esc_attr( $widget_title ); ?>" />
+                </p>
+                <p style="color: #333;">
+                    <?php esc_html_e( 'Leave the title field blank, above, to use the title from the page set in the next field', 'a-z-listing' ); ?>
+                </p>
+            </div>
+            <div class="a-z-listing-target-post-wrapper">
+                <p>
+                    <label for="<?php echo esc_attr( $target_post_id ); ?>">
+                        <?php esc_html_e( 'Sitemap A-Z page', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="text" class="widefat a-z-listing-target-post-title"
+                        id="<?php echo esc_attr( $target_post_title_id ); ?>"
+                        name="<?php echo esc_attr( $target_post_title_name ); ?>"
+                        value="<?php echo esc_attr( $target_post_title ); ?>" />
+                    <input type="hidden"
+                        id="<?php echo esc_attr( $target_post_id ); ?>"
+                        name="<?php echo esc_attr( $target_post_name ); ?>"
+                        value="<?php echo esc_attr( $target_post ); ?>" />
+                </p>
+                <p>
+                    <?php esc_html_e( 'Type some or all of the title of the page you want links to point at. Ensure this input field is not selected when you save the settings.', 'a-z-listing' ); ?>
+                    <?php esc_html_e( 'Matching posts will be shown as you type. Click on the correct post from the matches to update the setting.', 'a-z-listing' ); ?>
+                </p>
+            </div>
+            <div class="a-z-listing-display-type-wrapper">
+                <p>
+                    <label for="<?php echo esc_attr( $display_type_id ); ?>">
+                        <?php esc_html_e( 'Display posts or terms?', 'a-z-listing' ); ?>
+                    </label>
+                    <select class="widefat a-z-listing-display-type"
+                        id="<?php echo esc_attr( $display_type_id ); ?>"
+                        name="<?php echo esc_attr( $display_type_name ); ?>">
+                        <option value="posts"
+                            <?php echo ( 'terms' !== $display_type ) ? 'selected' : ''; ?>>
+                            <?php esc_html_e( 'Posts', 'a-z-listing' ); ?>
+                        </option>
+                        <option value="terms"
+                            <?php echo ( 'terms' === $display_type ) ? 'selected' : ''; ?>>
+                            <?php esc_html_e( 'Taxonomy terms', 'a-z-listing' ); ?>
+                        </option>
+                    </select>
+                </p>
+            </div>
+            <div class="a-z-listing-post-type-wrapper" <?php echo ( 'terms' !== $display_type ) ? '' : 'style="display: none;"'; ?>>
+                <p>
+                    <label for="<?php echo esc_attr( $listing_post_type_id ); ?>">
+                        <?php esc_html_e( 'Post-type to display', 'a-z-listing' ); ?>
+                    </label>
+                    <select class="widefat a-z-listing-post-type"
+                        id="<?php echo esc_attr( $listing_post_type_id ); ?>"
+                        name="<?php echo esc_attr( $listing_post_type_name ); ?>"
+                        <?php echo ( 'terms' !== $display_type ) ? '' : 'disabled'; ?>>
+                        <?php foreach ( $public_post_types as $k => $t ) : ?>
+                            <option value="<?php echo esc_attr( $k ); ?>"
+                                <?php echo ( $k === $listing_post_type ) ? 'selected' : ''; ?>>
+                                <?php echo esc_html( $t->labels->name ); ?>
+                            </option>
+                        <?php endforeach; ?>
+                    </select>
+                </p>
+            </div>
+            <div class="a-z-listing-parent-post-wrapper" <?php echo ( 'terms' !== $display_type ) ? '' : 'style="display: none"'; ?>>
+                <p>
+                    <label for="<?php echo esc_attr( $listing_parent_post_id ); ?>">
+                        <?php esc_html_e( 'Show only children of this post (ID)', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="text" class="widefat a-z-listing-parent-post-title"
+                        id="<?php echo esc_attr( $listing_parent_post_title_id ); ?>"
+                        name="<?php echo esc_attr( $listing_parent_post_title_name ); ?>"
+                        <?php echo ( 'terms' !== $display_type ) ? '' : 'disabled'; ?>
+                        value="<?php echo esc_attr( $listing_parent_post_title ); ?>" />
+                    <input type="hidden"
+                        id="<?php echo esc_attr( $listing_parent_post_id ); ?>"
+                        name="<?php echo esc_attr( $listing_parent_post_name ); ?>"
+                        value="<?php echo esc_attr( $listing_parent_post ); ?>" />
+                </p>
+                <p>
+                    <?php esc_html_e( 'Type some or all of the title of the post to limit the listing to only the children of that post. Ensure this input field is not selected when you save the settings.', 'a-z-listing' ); ?>
+                    <?php esc_html_e( 'Matching posts will be shown as you type. Click on the correct post from the matches to update the setting.', 'a-z-listing' ); ?>
+                </p>
+                <p>
+                    <label for="<?php echo esc_attr( $listing_all_children_id ); ?>">
+                        <?php esc_html_e( 'Include grand-children?', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="checkbox" class="a-z-listing-all-children"
+                        id="<?php echo esc_attr( $listing_all_children_id ); ?>"
+                        name="<?php echo esc_attr( $listing_all_children_name ); ?>"
+                        <?php echo ( isset( $listing_all_children ) && 'true' === $listing_all_children ) ? 'checked' : ''; ?> />
+                </p>
+            </div>
+            <div class="a-z-listing-taxonomy-wrapper" <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>>
+                <p>
+                    <label for="<?php echo esc_attr( $listing_taxonomy_id ); ?>">
+                        <?php esc_html_e( 'Taxonomy to display', 'a-z-listing' ); ?>
+                    </label>
+                    <select class="widefat a-z-listing-taxonomy"
+                        id="<?php echo esc_attr( $listing_taxonomy_id ); ?>"
+                        name="<?php echo esc_attr( $listing_taxonomy_name ); ?>"
+                        <?php echo ( 'terms' === $display_type ) ? '' : 'disabled'; ?>>
+                        <?php foreach ( $public_taxonomies as $k => $t ) : ?>
+                            <option value="<?php echo esc_attr( $k ); ?>"
+                                <?php echo ( $k === $listing_taxonomy ) ? 'selected' : ''; ?>>
+                                <?php echo esc_html( $t->labels->name ); ?>
+                            </option>
+                        <?php endforeach; ?>
+                    </select>
+                </p>
+            </div>
+            <div class="a-z-listing-parent-term-wrapper" <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>>
+                <p>
+                    <label for="<?php echo esc_attr( $listing_parent_term_id ); ?>">
+                        <?php esc_html_e( 'Parent term to display children of', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="text" class="widefat a-z-listing-parent-term"
+                        id="<?php echo esc_attr( $listing_parent_term_id ); ?>"
+                        name="<?php echo esc_attr( $listing_parent_term_name ); ?>"
+                        value="<?php echo esc_attr( $listing_parent_term ); ?>" />
+                </p>
+            </div>
+            <div class="a-z-listing-include-terms-wrapper">
+                <p>
+                    <label for="<?php echo esc_attr( $listing_terms_include_id ); ?>">
+                        <?php esc_html_e( 'Terms to include (IDs)', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="text" class="widefat a-z-listing-include-terms"
+                        id="<?php echo esc_attr( $listing_terms_include_id ); ?>"
+                        name="<?php echo esc_attr( $listing_terms_include_name ); ?>"
+                        value="<?php echo esc_attr( $listing_terms_include ); ?>" />
+                </p>
+            </div>
+            <div class="a-z-listing-exclude-terms-wrapper" <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>>
+                <p>
+                    <label for="<?php echo esc_attr( $listing_terms_exclude_id ); ?>">
+                        <?php esc_html_e( 'Terms to exclude (IDs)', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="text" class="widefat a-z-listing-exclude-terms"
+                        id="<?php echo esc_attr( $listing_terms_exclude_id ); ?>"
+                        name="<?php echo esc_attr( $listing_terms_exclude_name ); ?>"
+                        value="<?php echo esc_attr( $listing_terms_exclude ); ?>" />
+                </p>
+            </div>
+            <div class="a-z-listing-hide-empty-terms-wrapper" <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>>
+                <p>
+                    <label for="<?php echo esc_attr( $listing_hide_empty_terms_id ); ?>">
+                        <?php esc_html_e( 'Hide empty terms', 'a-z-listing' ); ?>
+                    </label>
+                    <input type="checkbox" class="a-z-listing-hide-empty-terms"
+                        id="<?php echo esc_attr( $listing_hide_empty_terms_id ); ?>"
+                        name="<?php echo esc_attr( $listing_hide_empty_terms_name ); ?>"
+                        <?php echo ( isset( $listing_hide_empty_terms ) && 'true' === $listing_hide_empty_terms ) ? 'checked' : ''; ?> />
+                </p>
+            </div>
         </div>
-        <div>
-            <p>
-                <label for="<?php echo esc_attr( $target_post_id ); ?>">
-                    <?php esc_html_e( 'Site map A-Z page', 'a-z-listing' ); ?>
-                </label>
-                <input class="widefat" type="text"
-                    id="<?php echo esc_attr( $target_post_title_id ); ?>"
-                    name="<?php echo esc_attr( $target_post_title_name ); ?>"
-                    value="<?php echo esc_attr( $target_post_title ); ?>" />
-                <input type="hidden"
-                    id="<?php echo esc_attr( $target_post_id ); ?>"
-                    name="<?php echo esc_attr( $target_post_name ); ?>"
-                    value="<?php echo esc_attr( $target_post ); ?>" />
-            </p>
-        </div>
-        <div>
-            <p>
-                <label for="<?php echo esc_attr( $display_type_id ); ?>">
-                    <?php esc_html_e( 'Display posts or terms?', 'a-z-listing' ); ?>
-                </label>
-                <select class="widefat"
-                    id="<?php echo esc_attr( $display_type_id ); ?>"
-                    name="<?php echo esc_attr( $display_type_name ); ?>">
-                    <option value="posts"
-                        <?php echo ( 'terms' !== $display_type ) ? 'selected' : ''; ?>>
-                        <?php esc_html_e( 'Posts', 'a-z-listing' ); ?>
-                    </option>
-                    <option value="terms"
-                        <?php echo ( 'terms' === $display_type ) ? 'selected' : ''; ?>>
-                        <?php esc_html_e( 'Taxonomy terms', 'a-z-listing' ); ?>
-                    </option>
-                </select>
-            </p>
-        </div>
-        <div <?php echo ( 'terms' !== $display_type ) ? '' : 'style="display: none;"'; ?>
-            id="<?php echo esc_attr( $listing_post_type_wrapper_id ); ?>">
-            <p>
-                <label for="<?php echo esc_attr( $listing_post_type_id ); ?>">
-                    <?php esc_html_e( 'Post-type to display', 'a-z-listing' ); ?>
-                </label>
-                <select class="widefat"
-                    id="<?php echo esc_attr( $listing_post_type_id ); ?>"
-                    name="<?php echo esc_attr( $listing_post_type_name ); ?>"
-                    <?php echo ( 'terms' !== $display_type ) ? '' : 'disabled'; ?>>
-                    <?php foreach ( $public_post_types as $k => $t ) : ?>
-                        <option value="<?php echo esc_attr( $k ); ?>"
-                            <?php echo ( $k === $listing_post_type ) ? 'selected' : ''; ?>>
-                            <?php echo esc_html( $t->labels->name ); ?>
-                        </option>
-                    <?php endforeach; ?>
-                </select>
-            </p>
-        </div>
-        <div <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>
-            id="<?php echo esc_attr( $listing_taxonomy_wrapper_id ); ?>">
-            <p>
-                <label for="<?php echo esc_attr( $listing_taxonomy_id ); ?>">
-                    <?php esc_html_e( 'Taxonomy to display', 'a-z-listing' ); ?>
-                </label>
-                <select class="widefat"
-                    id="<?php echo esc_attr( $listing_taxonomy_id ); ?>"
-                    name="<?php echo esc_attr( $listing_taxonomy_name ); ?>"
-                    <?php echo ( 'terms' === $display_type ) ? '' : 'disabled'; ?>>
-                    <?php foreach ( $public_taxonomies as $k => $t ) : ?>
-                        <option value="<?php echo esc_attr( $k ); ?>"
-                            <?php echo ( $k === $listing_taxonomy ) ? 'selected' : ''; ?>>
-                            <?php echo esc_html( $t->labels->name ); ?>
-                        </option>
-                    <?php endforeach; ?>
-                </select>
-            </p>
-        </div>
-        <div <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>
-            id="<?php echo esc_attr( $listing_parent_term_wrapper_id ); ?>">
-            <p>
-                <label for="<?php echo esc_attr( $listing_parent_term_id ); ?>">
-                    <?php esc_html_e( 'Parent term to display children of', 'a-z-listing' ); ?>
-                </label>
-                <input class="widefat" type="text"
-                    id="<?php echo esc_attr( $listing_parent_term_id ); ?>"
-                    name="<?php echo esc_attr( $listing_parent_term_name ); ?>"
-                    value="<?php echo esc_attr( $listing_parent_term ); ?>" />
-            </p>
-        </div>
-        <div>
-            <p>
-                <label for="<?php echo esc_attr( $listing_terms_include_id ); ?>">
-                    <?php esc_html_e( 'Terms to include (IDs)', 'a-z-listing' ); ?>
-                </label>
-                <input class="widefat" type="text"
-                    id="<?php echo esc_attr( $listing_terms_include_id ); ?>"
-                    name="<?php echo esc_attr( $listing_terms_include_name ); ?>"
-                    value="<?php echo esc_attr( $listing_terms_include ); ?>" />
-            </p>
-        </div>
-        <div <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>
-            id="<?php echo esc_attr( $listing_terms_exclude_wrapper_id ); ?>">
-            <p>
-                <label for="<?php echo esc_attr( $listing_terms_exclude_id ); ?>">
-                    <?php esc_html_e( 'Terms to exclude (IDs)', 'a-z-listing' ); ?>
-                </label>
-                <input class="widefat" type="text"
-                    id="<?php echo esc_attr( $listing_terms_exclude_id ); ?>"
-                    name="<?php echo esc_attr( $listing_terms_exclude_name ); ?>"
-                    value="<?php echo esc_attr( $listing_terms_exclude ); ?>" />
-            </p>
-        </div>
-        <div <?php echo ( 'terms' === $display_type ) ? '' : 'style="display: none;"'; ?>
-            id="<?php echo esc_attr( $listing_hide_empty_terms_wrapper_id ); ?>">
-            <p>
-                <label for="<?php echo esc_attr( $listing_hide_empty_terms_id ); ?>">
-                    <?php esc_html_e( 'Hide empty terms', 'a-z-listing' ); ?>
-                </label>
-                <input type="checkbox"
-                    id="<?php echo esc_attr( $listing_hide_empty_terms_id ); ?>"
-                    name="<?php echo esc_attr( $listing_hide_empty_terms_name ); ?>"
-                    <?php echo ( isset( $listing_hide_empty_terms ) && 'true' === $listing_hide_empty_terms ) ? 'checked' : ''; ?> />
-            </p>
-        </div>
-        <script type="text/javascript">
-            jQuery(document).ready(function($) {
-                const target_post                      = document.getElementById( '<?php echo esc_html( $target_post_id ); ?>' );
-                const target_post_title                = document.getElementById( '<?php echo esc_html( $target_post_title_id ); ?>' );
-                const display_type                     = document.getElementById( '<?php echo esc_html( $display_type_id ); ?>' );
-                const listing_post_type                = document.getElementById( '<?php echo esc_html( $listing_post_type_id ); ?>' );
-                const listing_post_type_wrapper        = document.getElementById( '<?php echo esc_html( $listing_post_type_wrapper_id ); ?>' );
-                const listing_taxonomy                 = document.getElementById( '<?php echo esc_html( $listing_taxonomy_id ); ?>' );
-                const listing_taxonomy_wrapper         = document.getElementById( '<?php echo esc_html( $listing_taxonomy_wrapper_id ); ?>' );
-                const listing_parent_term              = document.getElementById( '<?php echo esc_html( $listing_parent_term_id ); ?>' );
-                const listing_parent_term_wrapper      = document.getElementById( '<?php echo esc_html( $listing_parent_term_wrapper_id ); ?>' );
-                const listing_hide_empty_terms         = document.getElementById( '<?php echo esc_html( $listing_hide_empty_terms_id ); ?>' );
-                const listing_hide_empty_terms_wrapper = document.getElementById( '<?php echo esc_html( $listing_hide_empty_terms_wrapper_id ); ?>' );
-                const listing_terms_exclude            = document.getElementById( '<?php echo esc_html( $listing_terms_exclude_id ); ?>' );
-                const listing_terms_exclude_wrapper    = document.getElementById( '<?php echo esc_html( $listing_terms_exclude_wrapper_id ); ?>' );
-                function switch_taxonomy_or_posts() {
-                    if ( 'terms' === display_type.value ) {
-                        listing_post_type.setAttribute( 'disabled', 'disabled' );
-                        listing_post_type_wrapper.style.display = 'none';
-                        listing_taxonomy.removeAttribute( 'disabled' );
-                        listing_taxonomy_wrapper.style.display = 'unset';
-                        listing_parent_term.removeAttribute( 'disabled' );
-                        listing_parent_term_wrapper.style.display = 'unset';
-                        listing_hide_empty_terms.removeAttribute( 'disabled' );
-                        listing_hide_empty_terms_wrapper.style.display = 'unset';
-                        listing_terms_exclude.removeAttribute( 'disabled' );
-                        listing_terms_exclude_wrapper.style.display = 'unset';
-                    } else {
-                        listing_post_type.removeAttribute( 'disabled' );
-                        listing_post_type_wrapper.style.display = 'unset';
-                        listing_taxonomy.setAttribute( 'disabled', 'disabled' );
-                        listing_taxonomy_wrapper.style.display = 'none';
-                        listing_parent_term.setAttribute( 'disabled', 'disabled' );
-                        listing_parent_term_wrapper.style.display = 'none';
-                        listing_hide_empty_terms.setAttribute( 'disabled', 'disabled' );
-                        listing_hide_empty_terms_wrapper.style.display = 'none';
-                        listing_terms_exclude.setAttribute( 'disabled', 'disabled' );
-                        listing_terms_exclude_wrapper.style.display = 'none';
+                    }
+                }
-                switch_taxonomy_or_posts();
-                display_type.addEventListener( 'change', switch_taxonomy_or_posts );
-                $( target_post_title ).autocomplete( {
-                    source: function( post_title, response ) {
-                        $.ajax( {
-                            url:      '/wp-admin/admin-ajax.php',
-                            type:     'POST',
-                            dataType: 'json',
-                            data: {
-                                action:     'get_a_z_listing_autocomplete_post_titles',
-                                post_title,
-                            },
-                            success: function( data ) {
-                                response( data );
-                            },
-                            error: function() {
-                                response();
-                            },
-                        } );
-                    },
-                    select: function( event, ui ) {
-                        event.preventDefault();
-                        target_post.value       = ui.item.value;
-                        target_post_title.value = ui.item.label;
-                    },
-                } );
-            } );
-        </script>
         <?php
+    }
 …
         $instance['target_post_title'] = strip_tags( $new_instance['target_post_title'] );
         $instance['post_type']         = strip_tags( $new_instance['post_type'] );
-        $instance['parent']            = (int) $new_instance['parent'];
         $instance['taxonomy']          = strip_tags( $new_instance['taxonomy'] );
+        $instance['parent_post']       = (int) $new_instance['parent_post'];
+        $instance['all_children']      = 'on' === $new_instance['all_children'] ? 'true' : 'false';
         $instance['parent_term']       = strip_tags( $new_instance['parent_term'] );
         $instance['terms']             = strip_tags( $new_instance['terms'] );
 …
         $instance['hide_empty_terms']  = 'on' === $new_instance['hide_empty_terms'] ? 'true' : 'false';
         if ( empty( $instance['target_post_title'] ) ) {
+        if ( empty( $new_instance['target_post_title'] ) ) {
             $instance['post'] = 0;
+        }
+        if ( empty( $new_instance['parent_post_title'] ) ) {
+            $instance['parent_post'] = 0;
+        }
 …
         $instance,
         array(
+            'all_children'     => 'true',
+            'exclude_terms'    => '',
+            'hide_empty_terms' => false,
+            'parent_post'      => '',
+            'parent_term'      => '',
+            'post'             => -1, // target.
+            'page'             => -1, // obsolete target.
+            'post_type'        => 'page',
+            'taxonomy'         => '',
+            'terms'            => '',
             'title'            => '',
-            'post'             => -1, // target.
             'type'             => 'posts',
-            'taxonomy'         => '',
-            'post_type'        => 'page',
-            'terms'            => '',
-            'exclude_terms'    => '',
-            'parent_term'      => '',
-            'hide_empty_terms' => false,
+        )
     );
 …
     $title  = esc_html( $instance['title'] );
     $target = '';
+    if ( empty( $title ) ) {
+        if ( $instance['post'] > 0 ) { // target.
+            $title  = get_the_title( $instance['post'] );
+            $target = get_the_permalink( $instance['post'] );
+        } else {
+            $title = esc_html__( 'A-Z Listing', 'a-z-listing' );
+    if ( 0 < $instance['post'] || 0 < $instance['page'] ) { // target.
+        $target_id = (int) $instance['post']; // target.
+        if ( ! ( 0 < $instance['post'] ) ) {
+            $target_id = (int) $instance['page']; // obsolete target.
+        }
+    }
+    $hide_empty = true === $instance['hide_empty_terms'] ? 'true' : 'false';
+        $target_url = get_the_permalink( $target_id );
+        if ( empty( $title ) ) {
+            $title = get_the_title( $target_id );
+        }
+    } elseif ( empty( $title ) ) {
+        $title = esc_html__( 'A-Z Listing', 'a-z-listing' );
+    }
+    $hide_empty_terms = true === $instance['hide_empty_terms'] ? 'true' : 'false';
     $ret  = '';
 …
     $ret .= do_shortcode(
         "[a-z-listing
+            return='letters'
+            target='{$target}'
+            alphabet=''
             display='{$instance['type']}'
+            taxonomy='{$instance['taxonomy']}'
+            alphabet=''
+            exclude-posts=''
+            exclude-terms='{$instance['exclude_terms']}'
+            get-all-children='{$instance['all_children']}'
             group-numbers=''
             grouping=''
+            hide-empty-terms='{$hide_empty_terms}'
             numbers='hide'
+            parent-post='{$instance['parent_post']}'
+            parent-term='{$instance['parent_term']}'
             post-type='{$instance['post_type']}'
+            exclude-posts=''
+            return='letters'
+            target='{$target_url}'
+            taxonomy='{$instance['taxonomy']}'
             terms='{$instance['terms']}'
-            exclude-terms='{$instance['exclude_terms']}'
-            parent-term='{$instance['parent_term']}'
-            hide-empty-terms='{$hide_empty}'
         ]"
     );
 …
 /**
+ * Retrive posts by title.
+ *
+ * @since 2.1.0
+ * @param string $post_title the title to search for.
+ * @param string $post_type the post type to search within.
+ * @return array the post IDs that are found.
+ */
+function a_z_listing_get_posts_by_title( $post_title, $post_type = '' ) {
+    global $wpdb;
+    $post_title = '%' . $wpdb->esc_like( $post_title ) . '%';
+    if ( ! empty( $post_type ) ) {
+        return $wpdb->get_results(
+            $wpdb->prepare(
+                "SELECT `ID`, `post_title` FROM `$wpdb->posts`
+                WHERE `post_title` LIKE %s AND `post_type` = %s AND `post_status` = 'publish'",
+                $post_title,
+                $post_type
+            )
+        );
+    } else {
+        return $wpdb->get_results(
+            $wpdb->prepare(
+                "SELECT `ID`, `post_title` FROM `$wpdb->posts`
+                WHERE `post_title` LIKE %s AND `post_status` = 'publish'",
+                $post_title
+            )
+        );
+    }
+}
+/**
  * Ajax responder for A_Z_Listing_Widget configuration
+ *
+ * @since 2.0.0
  */
 function a_z_listing_autocomplete_post_titles() {
+    global $wpdb;
+    $post_title = '%' . $wpdb->esc_like( stripslashes( $_POST['post_title']['term'] ) ) . '%';
+    $results = $wpdb->get_results(
+        $wpdb->prepare(
+            "SELECT `ID`, `post_title` FROM `$wpdb->posts`
+            WHERE `post_title` LIKE %s AND `post_status` = 'publish'",
+            $post_title
+        )
+    );
+    $post_title = stripslashes( $_POST['post_title']['term'] );
+    $post_type  = stripslashes( $_POST['post_type'] );
+    $results = a_z_listing_get_posts_by_title( $post_title, $post_type );
     $titles = array();
 …
 /**
  * Enqueue the jquery-ui autocomplete script
+ *
+ * @since 2.0.0
  */
 function a_z_listing_autocomplete_script() {

Plugin Directory

Context Navigation

Legend:

a-z-listing/trunk/Gruntfile.js

a-z-listing/trunk/README.md

a-z-listing/trunk/a-z-listing.php

a-z-listing/trunk/changelog.md

a-z-listing/trunk/classes/class-a-z-listing-grouping.php

a-z-listing/trunk/classes/class-a-z-listing-indices.php

a-z-listing/trunk/classes/class-a-z-listing-numbers.php

a-z-listing/trunk/classes/class-a-z-listing.php

a-z-listing/trunk/css/a-z-listing-default.css

a-z-listing/trunk/css/a-z-listing-default.css.map

a-z-listing/trunk/css/a-z-listing-default.scss

a-z-listing/trunk/functions/enqueues.php

a-z-listing/trunk/functions/helpers.php

a-z-listing/trunk/functions/scripts.php

a-z-listing/trunk/functions/shortcode.php

a-z-listing/trunk/functions/styles.php

a-z-listing/trunk/languages/a-z-listing.pot

a-z-listing/trunk/package-lock.json

a-z-listing/trunk/readme.txt

a-z-listing/trunk/scripts/a-z-listing-tabs.js

a-z-listing/trunk/templates/a-z-listing.example.php

a-z-listing/trunk/templates/a-z-listing.php

a-z-listing/trunk/widgets/class-a-z-listing-widget.php

Download in other formats: