Support Center

Frequently asked questions and support documentation for RatingWidget.


Categories

FAQ

  • My homepage not showing any ratings, what’s wrong?

    Make sure your Front Page ratings are enabled for excerpts. In addition, your theme’s front page template must use the_excerpt() or the_content() methods to show/load the excerpts. We use this method’s hook to add the rating code. You can either try to fix that, or you can add our PHP shortcodes directly to your theme’s front page template.

  • The RatingWidget WordPress plugin don’t show ratings on my comments, what’s wrong?

    First, make sure you’ve enabled the ratings for comments in your admin’s dashboard. Once you sure it’s enabled, but still doesn’t work, a common cause can be that your theme isn’t using comment_text() to display the comments text. A common mistake by theme developers is the use of get_comment_text() instead of comment_text(). Try to switch between those and it should fix the issue. If you are awesome, contact the theme developer and let him know about the issue so he can fix it for everyone else.

  • Can I add a rating inside my WordPress post’s content?

    We created a special shortcode you can use inside your posts / pages editor.

    For post ratings:

    • Current post rating - [ratingwidget]
    • Specified post rating - [ratingwidget post_id=123]

    For page ratings:

    • Current page rating - [ratingwidget type="page"]
    • Specified page rating - [ratingwidget type="page" post_id=123]

    For random ratings (not bound to any page/post):

    • Rating - [ratingwidget_raw id="1" title="my-title" type="page"]

    Rich-Snippets support:
    If you are using our Professional or Business plan which supports Rich-Snippets integration, and you want that the rendered rating will have the relevant schema, please add the add_schema=true attribute to the shortcode. For example:
    [ratingwidget post_id=123 add_schema=true]

    Note: If you already have a rating with schema.org on the same page, adding additional rating with schema.org metadata will confuse search engines, and will cause your ratings disappear from SERP.

  • Is there any PHP shortcodes I can use for my custom posts templates?

    We created several custom PHP shortcodes to make it easy for you adding RatingWidget into your custom templates or even if you want to customize the exact location of the ratings in your pages.

    Here are the shortcodes:

    • Output post / page / comment rating:
      function rw_the_post_rating($postID = false, $class = 'blog-post', $schema = false);
    • Return post / page / comment rating:
      function rw_get_post_rating($postID = false, $class = 'blog-post', $schema = false);
    • Output user rating:
      function rw_the_user_rating($userID = false);
    • Return user rating:
      function rw_get_user_rating($userID = false);

    Usage example:

    <?php rw_the_post_rating(14, 'front-post'); ?>

    Params:

    • $postID – The post id. Defaults to current’s loop post id.
    • $class - Rating class/type. For front page posts use ‘front-post’, for posts use ‘blog-post’, for pages user ‘page’, for comments use ‘comment’.
    • $schema - If TRUE, add Rich-Snippets schema.org metadata (only for Professional customers).
    • $userID - User ID. Defaults to current’s loop user.

    You can find the shortcodes implementation in /rating-widget/lib/rw-shortcodes.php

  • Do you have a refresh code for Ajax loaded content?

    In order to refresh / re-render the ratings on the page all you need to do is execute the following JavaScript line.

    RW.render(null, true);

    You can add the following code snippet right before your closing </body> tag (requires jQuery support) and it will automatically do the job.

    <script type="text/javascript">
        (function($){
            $(document).ajaxSuccess(function() {
                setTimeout(function(){
                    if ("undefined" !== typeof(RW))
                        RW.render(null, true);
                }, 500);
            });
        })(jQuery);
    </script>

    If you care about efficiency, call this method only after you add new ratings’ HTML containers (not on every Ajax call).

    Using the WordPress Plugin?

    To add the snippet right in your WordPress’ footer, add the following code to your theme’s functions.php file:

        /* Append ratings render-er after ajax call.
        ------------------------------------------*/
        function rw_render_ratings_after_ajax()
        {
    ?>
    <script type="text/javascript">
        (function($){
            $(document).ajaxSuccess(function() {
                setTimeout(function(){
                    if ("undefined" !== typeof(RW))
                        RW.render(null, true);
                }, 500);
            });
        })(jQuery);
    </script>
    <?php        
        }
    
        add_action('wp_footer', 'rw_render_ratings_after_ajax');
    
  • I just upgraded RatingWidget for WordPress plugin to Professional. What do I need to do to activate the Rich-Snippets?

    Rich Snippet is automatically activated after the upgrade. The markup will be added automatically to your posts and pages once they receive at least one vote. All you need to do is to test the markup by following these simple steps:

  • How to hide the content recommendations shown in the after vote report popup?

    To disable recommendations shown in the report popup, simply add this code snippet

    "hideRecommendations": true,

    to your existing integration code options. Your new integration code should be something like:

        ...
        options: {
           "hideRecommendations": true,
           "size": "medium",
           "style": "oxygen",
        }
        ...
    

    WordPress Plugin User?

    • Go to Dashboard > RatingWidget
    • Select the rating type tab you’d like to modify
    • Scroll to the bottom of the setting page until you get to the Power User Settings
    • Check the Activate / in-activate checkbox to activate the Power User Settings.
    • By default, the hideRecommendations option will already be there as one of the examples:
      options.hideRecommendations = true;
    • Delete all other preset functions if not needed or modify when necessary. Then click Save Changes and you’re all set!