WordPress Plugin Directory<\/a> ;3!<\/li>\n<\/ol>\n\n\nYou can use the dexs counter environment easily within your own WordPress theme. This is useful, if \nyou want to adapt the dexs counter design seamless to your theme. Please Note: You should always \ncheck, if the respective function exists with the php function_exists(function_name)<\/code> method!<\/p>\n\n- dexs_cr_get_views ($post_id, $type)<\/dt>\n
Get one of the four view counter numbers for the respective post.<\/p>\n\n
Parameters<\/strong><\/p>\n\n\n- $post_id<\/strong> (Required)<\/em>
\nThe respective post id. Use the get_the_ID()<\/code> WordPress function within a loop. <\/li>\n- $type<\/strong> (Optional)<\/em>
\nSet the view counter type by using one of the following strings<\/li>\n- \n
\n\"total\"<\/code> returns all registered clicks. (Default)<\/li>\n<\/ul><\/li>\n- \n
\n\"daily\"<\/code> returns all registered clicks for the current day.<\/li>\n<\/ul><\/li>\n- \n
\n\"unique\"<\/code> returns all unique clicks (one click \/ user).<\/li>\n<\/ul><\/li>\n- \n
\n\"daily_unique\"<\/code> returns all unique clicks (one click \/ user) for the current day. <\/li>\n<\/ul><\/li>\n<\/ul>\n\nReturn Values<\/strong><\/p>\n\nReturns the view counter number as integer<\/strong> or false<\/strong> if the $post_id parameter in invalid.<\/p><\/dd>\n- dexs_cr_has_viewed ($post_id)<\/dt>\n
Checks if the current user has already clicked on the respective post.<\/p>\n\n
Parameters<\/strong><\/p>\n\n\n- $post_id<\/strong> (Required)<\/em>
\nThe respective post id. Use the get_the_ID()<\/code> WordPress function within a loop. <\/li>\n<\/ul>\n\nReturn Values<\/strong><\/p>\n\nReturns true<\/strong> if the user has already clicked on the post, and false<\/strong> if not or if the \n$post_id parameter is invalid!<\/p><\/dd>\n- dexs_cr_get_rating ($post_id)<\/dt>\n
Get the rating data for the respective post.<\/p>\n\n
Parameters<\/strong><\/p>\n\n\n- $post_id<\/strong> (Required)<\/em>
\nThe respective post id. Use the get_the_ID()<\/code> WordPress function within a loop. <\/li>\n<\/ul>\n\nReturn Values<\/strong><\/p>\n\nReturns an array<\/strong> with the rating data or false<\/strong> on failure. Note: The rating data (or rather \nthe array keys) depends on your rating layout setting (see below), but the values are always \nintegers<\/strong> an represents the number of ratings \/ clicks on the respective rating value.<\/p>\n\n\n- On \"Single\"<\/strong>:
array(\"like\" => [int])<\/code><\/li>\n- On \"Double\"<\/strong>:
array(\"like\" => [int], \"dislike\" => [int])<\/code><\/li>\n- On \"3-Level\"<\/strong>:
array(\"1\" => [int], \"2\" => [int], \"3\" => [int])<\/code><\/li>\n- On \"5-Level\"<\/strong>:
array(\"1\" => [int], \"2\" => [int], \"3\" => [int], \"4\" => [int], \"5\" => [int])<\/code><\/li>\n<\/ul><\/dd>\n- dexs_cr_has_rated ($post_id, $value)<\/dt>\n
Checks if the current user has already rated yet and returns perhaps his rating value.<\/p>\n\n
Parameters<\/strong><\/p>\n\n\n- $post_id<\/strong> (Required)<\/em>
\nThe respective post id. Use the get_the_ID()<\/code> WordPress function within a loop. <\/li>\n- $value<\/strong> (Optional)<\/em>
\nChange the returning value:<\/li>\n- \n
\nfalse<\/code> checks only if the user has already rated. (Default)<\/li>\n<\/ul><\/li>\n- \n
\ntrue<\/code> checks if the user has already rated and returns the rate value. <\/li>\n<\/ul><\/li>\n<\/ul>\n\nReturn Values<\/strong><\/p>\n\n($value == false):<br \/>\n<\/code><\/pre>\n\nReturns true<\/strong> if the user has already rated yet or false<\/strong> if not or if the $post_id is invalid. \nNote: Returns NULL<\/strong> if the current user is within an excluded role!<\/p>\n\n($value == true):<br \/>\n<\/code><\/pre>\n\nReturns the respective rating value as string<\/strong> or an empty string<\/strong> if the current user hasn't \nrated yet. Note: Returns false<\/strong> if the $post_id is invalid and NULL<\/strong> if the current user is \nwithin an excluded role<\/p><\/dd>\n- dexs_cr_rating_link ($post_id, $value)<\/dt>\n
Parameters<\/strong>\nCreates one or more rating links with an WordPress nonce. Example: \nhttp:\/\/www.example.com\/post_permalink\/?dexs-nonce=nonce<\/em>&dexs=rating_value<\/p>\n\n\n- $post_id<\/strong> (Required)<\/em>
\nThe respective post id. Use the get_the_ID()<\/code> WordPress function within a loop. <\/li>\n- $value<\/strong> (Optional)<\/em>
\nConfigure the returning value:<\/li>\n- \n
\nNULL<\/code> all rating values, depending on the rating layout. (Default)<\/li>\n<\/ul><\/li>\n- \n
\n*value*<\/code> checks if the user has already rated and returns the rate value. <\/li>\n<\/ul><\/li>\n<\/ul>\n\nReturn Values<\/strong><\/p>\n\n($value == NULL):<br \/>\n<\/code><\/pre>\n\nReturns all rating links as array<\/strong> or **false* on failure. Note: The array keys are the \nrespective rating values, depending on the rating layout setting!<\/p>\n\n($value == value):<br \/>\n<\/code><\/pre>\n\nReturns the respective rating link as string<\/strong> or false<\/strong> on failure. Note: Returns also false \nif the given value doesn't match to the rating layout setting!<\/p><\/dd>\n- WP_Query<\/dt>\n
You can use the following settings to change the post order, of your costum WP_Query requests, \ndepending to view counter OR rating counter. Note: You may return an empty post list, if you use the \ndaily or daily_unique counter and if nobody has viewed a single post item on the day yet. Note also: \nThe Dexs.Counter plugin doesn't automatically add the counter meta data to all of your posts. So \neach post that havn't been clicked \/ rated yet are therefore not considered!<\/p>\n\n
<?php\n \/\/ The Most-Viewed Posts (Total)\n $query = array(\n \"order\" => \"DESC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_views_total\"\n );\n $posts = new WP_Query($query);\n\n \/\/ The Most-Viewed Posts (Unique)\n $query = array(\n \"order\" => \"DESC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_views_unique\"\n );\n $posts = new WP_Query($query);\n\n \/\/ The Most-Viewed Posts (Total \/ Today)\n $query = array(\n \"order\" => \"DESC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_views_today\"\n );\n $posts = new WP_Query($query);\n\n \/\/ The Most-Viewed Posts (Unique \/ Today)\n $query = array(\n \"order\" => \"DESC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_views_today_unique\"\n );\n $posts = new WP_Query($query);\n\n \/\/ The Best-Rated Posts\n $query = array(\n \"order\" => \"DESC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_ratings\"\n );\n $posts = new WP_Query($query);\n\n \/\/ The Worst-Rated Posts\n $query = array(\n \"order\" => \"ASC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_ratings\"\n );\n $posts = new WP_Query($query);\n\n \/\/ The Most-Rated Posts\n $query = array(\n \"order\" => \"DESC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_ratings_num\"\n );\n $posts = new WP_Query($query);\n\n \/\/ The Fewest-Rated Posts\n $query = array(\n \"order\" => \"ASC\",\n \"orderby\" => \"meta_value_num\",\n \"meta_key\" => \"dexs_ratings_num\"\n );\n $posts = new WP_Query($query);\n?>\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n\nVersion 0.1.3 (Alpha)<\/h4>\n\n\n- [FIX] Error on an empty counter diagram within the dashboard widget.<\/li>\n<\/ul>\n\n
Version 0.1.2 (Alpha)<\/h4>\n\n\n- [UPD] The design and data within the counter diagram.<\/li>\n
- [FIX] The counter diagram datasets had the wrong direction.<\/li>\n<\/ul>\n\n
Version 0.1.1 (Alpha)<\/h4>\n\n\n- [ADD] Trivial \"Humanity Test\" for the view counter.<\/li>\n
- [ADD] The
dexs-counter-verify<\/code> option as part of the new \"Humanity Test\".<\/li>\n- [FIX] The
_ip()<\/code> function has hashed the wrong value.<\/li>\n<\/ul>\n\nVersion 0.1.0 (Alpha)<\/h4>\n\n\n- First Release<\/li>\n<\/ul>","raw_excerpt":"A simple but powerful view counter and rating system, with own (dashboard) widgets, for your awesome WordPress website.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/52637","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=52637"}],"author":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sambrishes"}],"wp:attachment":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=52637"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=52637"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=52637"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=52637"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=52637"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=52637"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}