unread<\/em>.\nOf course, this works for the current logged user and will be skipped if the visitor is not logged.<\/p>\n\nExample :<\/p>\n\n
<?php\n$last_unread_topics_query_args = array(\n 'post_type' => bbp_topic_post_type(), \/\/or 'topic'\n 'posts_per_page' => 5,\n 'bbppu' => 'unread' \/\/only unread ones\n);\n\n$last_unread_topics_query = new WP_Query( $last_unread_topics_query_args );\n?>\n<\/code><\/pre><\/dd>\nHow does it work?<\/dt>\nbbPress Pencil Unread<\/em> handles differently the way forums & topics are set as read.<\/p>\n\n\nFor topics<\/strong>, a post meta bbppu_read_by<\/em> is attached to the topic each time a someone visits it; the meta value is the user ID. \u00a0When a new reply is added, all those metas are deleted.<\/p><\/li>\nFor forums<\/strong>, we compare the total count of topics with the total count of read topics for the current user. If it does not match, the forum is considered as unread.<\/p><\/li>\nMarking a forum (Mark all as read<\/em>) adds an entry with the forum ID and timestamp in bbppu_marked_forums<\/em> (usermeta). When determining if a topic has been read, we check if the topic's forum (or ancestors) has a mark more recent than the topic time.<\/p><\/li>\nMarking a forum will only set the topics from this forum as read. If there is super sticky topics<\/strong> displayed and that they belong to other forums, they will not be marked as read.<\/p><\/li>\n<\/ul><\/dd>\n- How can I use those functions outside of the plugin ?<\/dt>\n
Have a look at the file \/bbppu-template.php, which contains functions you could need.<\/p><\/dd>\n
- How can I see the plugin's log ?<\/dt>\n
The plugin will generate various notices and informations in the debug.log file, if debugging is enabled<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n\n1.3.0<\/h4>\n\n\n- Try to optimize queries that count forum topics in has_user_read_all_forum_topics():<\/li>\n
- 'no_found_rows' => true (see https:\/\/wpartisan.me\/tutorials\/wordpress-database-queries-speed-sql_calc_found_rows); so use count() instead of found->posts<\/li>\n
- 'update_post_term_cache' => false<\/li>\n<\/ul>\n\n
1.2.9<\/h4>\n\n\n- when comparing the topics read, only fetch IDs instead of full post<\/li>\n
- better debug.log report<\/li>\n<\/ul>\n\n
1.2.7<\/h4>\n\n\n- Added the 'bookmark' option, which adds (by default) a link after topics titles to go directly to the last read reply of that topic.<\/li>\n
- Forums marks is now an option<\/li>\n<\/ul>\n\n
1.2.6<\/h4>\n\n\n- Added meta query in has_user_read_all_forum_topics() to ignore posts below timestamp generated in get_skip_timestamp()<\/li>\n
- New function get_skip_timestamp()<\/li>\n<\/ul>\n\n
1.2.4<\/h4>\n\n\n- Use utf8 encoding when running $dom->loadHTML() to avoid problems with foreign languages (http:\/\/stackoverflow.com\/questions\/8218230\/php-domdocument-loadhtml-not-encoding-utf-8-correctly)<\/li>\n<\/ul>\n\n
1.2.3<\/h4>\n\n\n- No faking anymore ! Now the plugin really<\/strong> checks if a forum has its topics all read; while before, it was checking if the forum had been opened<\/strong>.<\/li>\n
- Allow to filter queries to get topics by read\/unread status (see FAQ)<\/li>\n
- fixed loadHTML() error (https:\/\/wordpress.org\/support\/topic\/just-upgraded-to-v-1-2-errors\/#post-8169136)<\/li>\n
- Arabic translation (thanks to Mohammad Sy)<\/li>\n
- has_user_read_all_forum_topics() : store the results in a short transient (5s) to avoid querying several times the same stuff.<\/li>\n
- deleted 'bbppu_forums_visits' usermetas and related functions (+ upgrade function)<\/li>\n
- topic_readby_metaname is now multiple (+ upgrade function) : do not store array of user IDs in a single meta, but store multiple metas with single user ID each time<\/li>\n<\/ul>\n\n
1.2.2<\/h4>\n\n\n- Do not show 'Mark as read' link if no activity since last marked.<\/li>\n
- fixed localization + french translation<\/li>\n
- stylesheet : RTL support<\/li>\n
- code cleanup<\/li>\n
- jQuery : when marking a forum as read, give the 'bbppu-read' class only to the topics of that forum (super sticky topics could be from another forum so they should remain unread)<\/li>\n<\/ul>\n\n
1.2.1<\/h4>\n\n\n- bug fixes : https:\/\/wordpress.org\/support\/topic\/just-upgraded-to-v-1-2-errors\/<\/li>\n<\/ul>\n\n
1.2<\/h4>\n\n\n- SCSS<\/li>\n
- options page<\/li>\n
- option to choose if items created before first user's visit should be marked as read ('test_registration_time') - https:\/\/wordpress.org\/support\/topic\/old-topics-as-unread\/<\/li>\n
- includes fontAwesome (loading icon : glyph instead of image)<\/li>\n
- Improved function get_user_mark_as_read_link()<\/li>\n
- Improved function process_mark_as_read()<\/li>\n
- improved ajax and nonces checks<\/li>\n
- supports forums hierarchy<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Removed first forum visit stuff. Remove old metas. Now check users registration time.<\/li>\n
- Lots of code cleanup<\/li>\n
- Improved has_user_read() function<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Improved marking as read - among others, checks if a parent forum has been marked.<\/li>\n
- Merged multiple \"bbppu_marked_forum_XX\" user meta keys into \"bbppu_marked_forums\" + upgrade function for older versions of the plugin.<\/li>\n
- New debug_log() function<\/li>\n
- Now handles forum categories<\/li>\n
- Merged functions 'has_user_read_forum' and 'has_user_read_topic' to 'has_user_read'<\/li>\n
- Merged functions 'forum_status_class' and 'topic_status_class' to 'post_status_class'<\/li>\n
- Removed bbP_Pencil_Unread variable 'prefix'<\/li>\n<\/ul>\n\n
1.0.9<\/h4>\n\n\n- Undefined index bug fix (http:\/\/wordpress.org\/support\/topic\/php-notice-for-mark_as_read_single_forum_link?replies=3#post-4842854)<\/li>\n<\/ul>\n\n
1.0.7<\/h4>\n\n\n- Fixed minor bug (http:\/\/wordpress.org\/support\/topic\/php-notice-for-mark_as_read_single_forum_link)<\/li>\n<\/ul>\n\n
1.0.6<\/h4>\n\n\n- Fixed minor bugs from 1.0.5<\/li>\n<\/ul>\n\n
1.0.5<\/h4>\n\n\n- Compatible with BuddyPress Groups Forums !<\/li>\n
- Backend integration (new_topic_backend,new_reply_backend)<\/li>\n
- Better firing sequence<\/li>\n
- Fixed styles for \"mark as read\" link<\/li>\n<\/ul>\n\n
1.0.4<\/h4>\n\n\n- Now saving the user's first visit (user meta key \"bbppu_first_visit\") to define older content as \"read\".<\/li>\n
- In 'setup_actions()', replaced wordpress hooks by bbpress hooks (to avoid plugin to crash while bbPress is not enabled)<\/li>\n<\/ul>\n\n
1.0.3<\/h4>\n\n\n- Added link \"mark as read\" for forums<\/li>\n
- Added filter 'bbppu_user_has_read_forum' on has_user_read_forum() and 'bbppu_user_has_read_topic' on has_user_read_topic()<\/li>\n<\/ul>\n\n
1.0.2<\/h4>\n\n\n- Timezone bug fix (thanks to Ruben!)<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- If a forum was set as \"read\" when a user posts a new topic or reply, keep its status to read after the new post has been saved (see function related to var $forum_was_read_before_new_post)<\/li>\n
- Store plugin version<\/li>\n
- Cleaned up the code<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- First release<\/li>\n<\/ul>","raw_excerpt":"bbPress Pencil Unread display which bbPress forums\/topics have already been read by the user.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/21817","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=21817"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/grosbouff"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=21817"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=21817"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=21817"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=21817"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=21817"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=21817"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}