There are no template files built into the plugin. However, the plugin will honor any template files you build into the theme to support customizing the display of book archives or single books.
From the plugin description/readme (emphasis added):
If you want to customize the way the reviews display, create and edit these template files:
- taxonomy.php
- archive-book-review.php
- single-book-review.php
All the front-facing code is in the form of filters which hook to the_content and those are located in inc/public.php but you should not edit those files directly.
In the comment you referenced, the “template file” I was referring to was a new template file created and added to the theme that would be named single-book-review.php as described above.
Thread Starter
Touda
(@touda)
Thanks, Chris. But I’m not sure if I know how to begin to create those templates :-/
Could you please put some basic example code for any of those files, for example archive-book-review.php? Thanks.
If your theme has an archive.php file, that’s your basic example code. If not, your theme will have an index.php file which would work the same way. More information about getting started with theme development can be found here: https://developer.wordpress.org/themes/basics/
There are public helper functions in the inc/func.php file in the plugin (https://github.com/jazzsequence/book-review-library/blob/master/inc/func.php) and
the code that the plugin uses to handle the markup is found in views/public.php (https://github.com/jazzsequence/book-review-library/blob/master/views/public.php). That’s the best I can offer besides actually walking you through how to develop a theme which is not a thing that I can really do here, I’m afraid. There are lots of online tutorials and videos on how to develop WordPress plugins and themes, some that I have done myself, personally, can be found here: https://www.pluralsight.com/authors/chris-reynolds
Thread Starter
Touda
(@touda)
I understand how template files work, and that I have to drop the shortcode and directly call the main functions in a different way in order to have the ISBN shown (or any other hack to the way the book reviews are displayed).
What I can’t find is the function I must call instead of putting:
[book-reviews covers=true order_by=title format=full]
Could you please tell which would be the equivalent function call? I can’t find where shortcodes are processed in the files you suggested. Am I missing something?
Thanks!
(I wish you can add a new parameter to the shortcode so we can show ISBN in future releases of the plugin.)
There isn’t a single function. The plugin uses custom taxonomies and custom post meta. The functions you need for the taxonomies can be found in inc/func.php. The function you would need specifically for the ISBN is just get_post_meta( $post_id, 'isbn', true ). How you populate the $post_id variable would depend on where you are in the code.
In the current incarnation, ISBN was never added for display purposes, it was solely added for search. In the next major revision, ISBN can be added to the display.
