pronamic/wp-pronamic-reviews-ratings

The Pronamic Reviews Ratings plugin for WordPress is a powerful, extendable reviews and ratings plugin.

Pronamic Reviews and Ratings

The Pronamic Reviews Ratings plugin for WordPress is a powerful, extendable reviews and ratings plugin.

Register Rating Type

<?php

function prefix_reviews_ratings_init() {
	pronamic_register_rating_type( 'trustworthy', __( 'Trustworthy', 'text_domain' ) );
	pronamic_register_rating_type( 'objective', __( 'Objective', 'text_domain' ) );
	pronamic_register_rating_type( 'complete', __( 'Complete', 'text_domain' ) );
	pronamic_register_rating_type( 'well_written', __( 'Well-written', 'text_domain' ) );
}

add_action( 'pronamic_reviews_ratings_init', 'prefix_reviews_ratings_init' );

Post Type Support

<?php

function prefix_reviews_ratings_init() {
	add_post_type_support( 'page', 'pronamic_ratings' );
}

add_action( 'pronamic_reviews_ratings_init', 'prefix_reviews_ratings_init' );

Post Type Rating Types Support

<?php

function prefix_init() {
	register_post_type( 'book', array(
		'public'                => true,
		'label'                 => __( 'Books', 'text_domain' ),
		'pronamic_rating_types' => array(
			'trustworthy',
			'objective',
			'complete',
			'well_written',
		),
	) );

	register_post_type( 'magazine', array(
		'public'                => true,
		'label'                 => __( 'Magazines', 'text_domain' ),
		'pronamic_rating_types' => array(
			'trustworthy',
			'well_written',
		),
	) );
}

add_action( 'init', 'prefix_init' );

Reviews Ratings Scores

<?php

function prefix_pronamic_reviews_ratings_scores( $scores ) {
	$scores = array( 10, 8, 6, 4, 2 );

	return $scores;
}

add_filter( 'pronamic_reviews_ratings_scores', 'prefix_pronamic_reviews_ratings_scores' );

Metadata

All the rating values are stored as meta data with the WordPress metadata API.

_pronamic_rating_value_$name
_pronamic_rating_count_$name

Schema.org

• http://schema.org/reviews
• http://schema.org/Review
• http://schema.org/Rating
• http://schema.org/AggregateRating

Tools for testing Schema.org markup

• Google Structured Data Testing Tool
• Structured Data Linter
• Stack Overflow question - Tool for testing Schema.org markup

WooCommerce Reviews and Ratings solution

• https://github.com/woothemes/woocommerce/blob/v2.1.6/includes/class-wc-comments.php
• https://github.com/woothemes/woocommerce/blob/v2.1.6/templates/single-product-reviews.php#L52

Other WordPress Reviews and Ratings solutions

• Rating-Widget
• WP-PostRatings
• Multi Rating
• WordPress Comment Rating Plugin
• kk Star Ratings
• 10+ Useful WordPress Rating Plugins
• Adding Custom Fields In WordPress’ Comment Form

JavaScript solutions

• jQuery Raty - A Star Rating Plugin
• RateIt - a jQuery (star) rating plugin

wp-pronamic-reviews-ratings's Issues

Blok 'Star ratings' toont onjuiste waarde op front-end op product-pagina

Als het blokje 'Star rating' wordt toegevoegd aan een pagina en een review type heeft geselecteerd toont deze een 'gemiddelde beoordeling'. Echter is dit (vermoedelijk) de gemiddelde beoordeling van dat hele onderdeel en niet alleen de waarde van het bewuste product.

In de structured data van het bewuste product staat wel de juiste waarde.

Rename `_pronamic_review_product_id` to `_pronamic_review_post_id`?

Is _pronamic_review_post_id perhaps more general and clear? For reviews for services, companies, etc., the term 'product' may be less obvious. And the term post_id makes it immediately clear that a post ID is stored in it.

Blok 'Star ratings' optie 'Show text' corrigeren

Bij het 'Star ratings' blok kan worden aangegeven of de tekst wel/niet moet worden getoond.

Als de optie 'Show text' staat uit gevinkt moet deze ook daadwerkelijk geen tekst tonen.
Zodra deze is aan gevinkt staat, moet de default tekst worden getoond, die overschreven kan worden.

Filteren op custom taxonomie niet mogelijk met Query Loop-blok

We hadden bedacht om de reviews op bijvoorbeeld de pagina van een product te gaan tonen m.b.v. het Query Loop-blok. Om de reviews voor dat specifieke product op te vragen (waarvan de post ID in de meta van reviews wordt bewaard als _pronamic_review_product_id), loop ik eigenlijk tegen een beperking van het Query Loop-blok aan. De filters zijn namelijk beperkt (categorie, tags, auteur, zoekwoord):

Ik heb het nu zo gemaakt dat de standaard taxonomie voor categorieën wordt gebruikt (slug = product post ID, naam = product post titel), maar mooier zou zijn als we een custom taxonomie kunnen gebruiken of de waarde uit de meta. Dat is echter (nog) niet mogelijk, blijkt ook uit een open issue in WordPress/gutenberg:

#34977 Query Loop: Add custom taxonomies to the Filters options