Dexs.Counter

1. 

   The settings page.

2. 

   The dashboard widget.

You can use the dexs counter environment easily within your own WordPress theme. This is useful, if
you want to adapt the dexs counter design seamless to your theme. Please Note: You should always
check, if the respective function exists with the php function_exists(function_name) method!

dexs_cr_get_views ($post_id, $type)

Get one of the four view counter numbers for the respective post.

Parameters

• $post_id (Required)
  The respective post id. Use the get_the_ID() WordPress function within a loop.
• $type (Optional)
  Set the view counter type by using one of the following strings
• • "total" returns all registered clicks. (Default)
• • "daily" returns all registered clicks for the current day.
• • "unique" returns all unique clicks (one click / user).
• • "daily_unique" returns all unique clicks (one click / user) for the current day.

Return Values

Returns the view counter number as integer or false if the $post_id parameter in invalid.

dexs_cr_has_viewed ($post_id)

Checks if the current user has already clicked on the respective post.

Parameters

• $post_id (Required)
  The respective post id. Use the get_the_ID() WordPress function within a loop.

Return Values

Returns true if the user has already clicked on the post, and false if not or if the
$post_id parameter is invalid!

dexs_cr_get_rating ($post_id)

Get the rating data for the respective post.

Parameters

• $post_id (Required)
  The respective post id. Use the get_the_ID() WordPress function within a loop.

Return Values

Returns an array with the rating data or false on failure. Note: The rating data (or rather
the array keys) depends on your rating layout setting (see below), but the values are always
integers an represents the number of ratings / clicks on the respective rating value.

• On “Single”: array("like" => [int])
• On “Double”: array("like" => [int], "dislike" => [int])
• On “3-Level”: array("1" => [int], "2" => [int], "3" => [int])
• On “5-Level”: array("1" => [int], "2" => [int], "3" => [int], "4" => [int], "5" => [int])

dexs_cr_has_rated ($post_id, $value)

Checks if the current user has already rated yet and returns perhaps his rating value.

Parameters

• $post_id (Required)
  The respective post id. Use the get_the_ID() WordPress function within a loop.
• $value (Optional)
  Change the returning value:
• • false checks only if the user has already rated. (Default)
• • true checks if the user has already rated and returns the rate value.

Return Values

($value == false):<br />

Returns true if the user has already rated yet or false if not or if the $post_id is invalid.
Note: Returns NULL if the current user is within an excluded role!

($value == true):<br />

Returns the respective rating value as string or an empty string if the current user hasn’t
rated yet. Note: Returns false if the $post_id is invalid and NULL if the current user is
within an excluded role

dexs_cr_rating_link ($post_id, $value)

Parameters
Creates one or more rating links with an WordPress nonce. Example:
http://www.example.com/post_permalink/?dexs-nonce=nonce&dexs=rating_value

• $post_id (Required)
  The respective post id. Use the get_the_ID() WordPress function within a loop.
• $value (Optional)
  Configure the returning value:
• • NULL all rating values, depending on the rating layout. (Default)
• • *value* checks if the user has already rated and returns the rate value.

Return Values

($value == NULL):<br />

Returns all rating links as array or **false* on failure. Note: The array keys are the
respective rating values, depending on the rating layout setting!

($value == value):<br />

Returns the respective rating link as string or false on failure. Note: Returns also false
if the given value doesn’t match to the rating layout setting!

WP_Query

You can use the following settings to change the post order, of your costum WP_Query requests,
depending to view counter OR rating counter. Note: You may return an empty post list, if you use the
daily or daily_unique counter and if nobody has viewed a single post item on the day yet. Note also:
The Dexs.Counter plugin doesn’t automatically add the counter meta data to all of your posts. So
each post that havn’t been clicked / rated yet are therefore not considered!

<?php
    // The Most-Viewed Posts (Total)
    $query = array(
        "order"     => "DESC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_views_total"
    );
    $posts = new WP_Query($query);

    // The Most-Viewed Posts (Unique)
    $query = array(
        "order"     => "DESC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_views_unique"
    );
    $posts = new WP_Query($query);

    // The Most-Viewed Posts (Total / Today)
    $query = array(
        "order"     => "DESC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_views_today"
    );
    $posts = new WP_Query($query);

    // The Most-Viewed Posts (Unique / Today)
    $query = array(
        "order"     => "DESC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_views_today_unique"
    );
    $posts = new WP_Query($query);

    // The Best-Rated Posts
    $query = array(
        "order"     => "DESC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_ratings"
    );
    $posts = new WP_Query($query);

    // The Worst-Rated Posts
    $query = array(
        "order"     => "ASC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_ratings"
    );
    $posts = new WP_Query($query);

    // The Most-Rated Posts
    $query = array(
        "order"     => "DESC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_ratings_num"
    );
    $posts = new WP_Query($query);

    // The Fewest-Rated Posts
    $query = array(
        "order"     => "ASC",
        "orderby"   => "meta_value_num",
        "meta_key"  => "dexs_ratings_num"
    );
    $posts = new WP_Query($query);
?>

Version 0.1.3 (Alpha)

• [FIX] Error on an empty counter diagram within the dashboard widget.

Version 0.1.2 (Alpha)

• [UPD] The design and data within the counter diagram.
• [FIX] The counter diagram datasets had the wrong direction.

Version 0.1.1 (Alpha)

• [ADD] Trivial “Humanity Test” for the view counter.
• [ADD] The dexs-counter-verify option as part of the new “Humanity Test”.
• [FIX] The _ip() function has hashed the wrong value.

Version 0.1.0 (Alpha)

• First Release