Dani Llewellyn

Hi,

Ignoring articles like “A”, “An”, “The” etc. is possible but will require some custom coding to implement. There is a filter which you can hook called a_z_listing_item_index_letter. You will need to create a function that returns the appropriate letter(s) for a post or term according to your own rules. The returned value must be an array of letters.

The page looks correct to me. The # category is correctly elided, because there are no posts within, and the posts shown are all filtered into the correct categories. Could you elaborate a bit further on how the listing is broken because I can’t see any incorrect behaviour in your linked page?

The first of your requirements is not possible via my plugin. You can only load the whole listing, not a part of it.

Your second requirement is achievable by copying the file from the plugin folder at templates/a-z-listing.php into your theme and removing the part near the top that calls $a_z_query->the_letters().

To add a thumbnail you need to again copy the file from the plugin’s templates folder into your theme (edit the file you copied above). You will want to add code that calls $item = $a_z_query->get_the_item_object( 'I understand the issues!' ); inside the while loop e.g. add it on line 35. Now you have $item containing your post or term you can call the WordPress-provided functions as you would elsewhere in your theme.

Hi,

The class name “no-posts” applied to the HTML source code is a historical artefact that I don’t want to change because it will break any CSS styles that people are currently using. It doesn’t mean anything beyond there being no items to display. The fact that it includes the word “posts” does not indicate that the plugin is trying to display posts instead of terms.

The taxonomy attribute needs to be the slug of the taxonomy. This is likely different from the name of the taxonomy. To find the slug, navigate to your administration screen and find the link “All brands” under the menu item on the left for one of your post-types e.g. posts (this is English, so you will likely see a translated version of this). Once you have found the link click it and then look in your web browser’s address bar. You should see an address similar to https://example.com/wp-admin/edit-tags.php?taxonomy=brands&post_type=post. Here the taxonomy name is “brands” so that is what I need to enter into the shortcode.

Hi,

yes you can! 🙂 You will want to try a shortcode similar to this:

[a-z-listing display="posts" post-type="product"]

If you want to restrict to products assigned to particular categories you can do:

[a-z-listing display="posts" post-type="product" taxonomy="product_cat" terms="category-to-use,another-category"]

Hi,

I just checked in Safari but can’t see the behaviour that you describe. What browser are you using? It might be browser-specific..

The anchors use the browser’s inbuilt functionality for scrolling the page to the appropriate position. This means that if you have anything on the page that is floating at the top of the window when you scroll it will obscure the target of the anchor. Browsers are unaware of these design decisions so you need to use javascript to intercept the anchor. The javascript below will move the page an extra 120 pixels down from the top of the viewport (the value -120 supplied to window.scrollBy()):

if ( document.readyState === 'loading' ) {
    document.addEventListener('DOMContentLoaded', fixAZListingScroll);
} else {
    fixAZListingScroll();
}
function fixAZListingScroll() {
    document.querySelectorAll( '.az-links a[href^="#letter-"]' )
    .forEach( function( a ) {
        a.addEventListener( 'click', function( e ) {
            e.preventDefault();
            const selector = this.href.replace( /.*(#letter-.*)/, '$1' );
            document.querySelector( selector ).scrollIntoView();
            window.scrollBy( 0, -120 );
        });
    });
}