* @since 5.0.0
* @version 6.0.0
*/
public function rpt_query_related_post_ids( $post_id, $query_args, &$debug = '' ) {
$query = new RPT_Related_Query( $this );
return $query->rpt_query_related_post_ids( $post_id, $query_args, $debug );
}
/**
* Function responsible for Thumbnail creation.
*
* @param boolean $show_top Position of the thumbnails.
* @param string $posts_number Number of posts to display.
* @param string $sort_by sort The thumbnails by some filter.
* @param string $main_title Thumbnail title.
* @param string $exclude post_ids To exclude from related posts thumbnails.
* @param int $author_id Limit results to this post author when greater than zero.
*
* @return string
* @version 6.0.0
*
* @since 1.0.0
*/
public function get_thumbnails($show_top = false, $posts_number = '', $sort_by = '', $main_title = '', $exclude = '', $author_id = 0)
{
$renderer = new RPT_Related_Renderer( $this );
return $renderer->rpt_render( $show_top, $posts_number, $sort_by, $main_title, $exclude, $author_id );
}
/**
* Show Related Post Categories.
*
* @param int $id The ID of post.
*
* @return string $category_list The structure of category list.
*
* @since 2.2.0
* @version 6.0.0
*/
public function relpoststh_category_list($id, $taxonomy, $post_type)
{
$category_list_struct = '';
$category_list = $this->relpoststh_get_featured_category($id, $taxonomy, $post_type);
// Bail early if category list is not found.
if (false === $category_list) {
return $category_list_struct;
}
/**
* Modifiy the category listings.
*
* @param int $id The ID of post.
* @return string $category_list The category list of current post at hand.
* @return string $taxonomy The taxonomy of a post.
*
* @since 2.2.0
* @version 4.3.0
*/
$category_list = apply_filters('relpoststh_show_all_categories', $category_list, $id, $taxonomy, $post_type);
$category_names = array();
if ( is_array( $category_list ) && ! empty( $category_list[0] ) ) {
foreach ( $category_list[0] as $item ) {
if ( isset( $item->name ) ) {
$category_names[] = $item->name;
}
}
} elseif ( ! empty( $category_list->name ) ) {
$category_names[] = $category_list->name;
}
$html = '';
if (!empty($category_names)) {
$category_names = implode(', ', $category_names);
$html .= '';
$html .= '' . esc_html($category_names) . '';
$html .= '
';
}
return $html;
}
/**
* Returns the featured category of a post based on YOAST SEO's meta-data.
*
* @param int $post_ID The post id.
* @param int $taxonomy_name The taxonomy name.
*
* @return object
* @since 2.2.0
* @version 6.0.0
*/
public function relpoststh_get_featured_category($post_ID, $taxonomy_name = 'category', $post_type = 'post')
{
// if the ID is not set, get the global ID.
if (!is_numeric($post_ID)) {
$post_ID = get_the_ID();
}
$args = array(
'post_type' => $post_type,
);
$taxonomy_name = is_array($taxonomy_name) ? $taxonomy_name[0] : $taxonomy_name;
$categories = wp_get_object_terms($post_ID, $taxonomy_name, $args);
if (!empty($categories) && is_wp_error($categories)) {
return false;
}
// get the yoast 'primary_category' from meta-data.
$yoast_primary_category = get_post_meta($post_ID, '_yoast_wpseo_primary_' . $taxonomy_name, true);
if ($yoast_primary_category) {
// if meta-data exists, find the primary category.
foreach ($categories as $category) {
if ($yoast_primary_category == $category->term_id) {
return $category;
}
}
}
// return the first category.
if (isset($categories) && !empty($categories[0])) {
return $categories[0];
}
}
/**
* This will add debugging information in HTML source
*
* @param $output
* @param $debug
* @param int $time time took to create the thumbnails
*
* @return $output debugged information
* @version 6.0.0
*/
public function finish_process($output, $debug, $time)
{
$devmode = rpt_settings_bool( 'general.dev_mode' );
if ($devmode) {
$time = microtime(true) - $time;
$debug .= "Plugin execution time: $time sec;";
$output .= '';
}
return $output;
}
/**
* Process text cut.
*
* @param string $text Text to cut.
* @param int $length Length to cut.
* @return string
* @version 6.0.0
*/
public function process_text_cut($text, $length)
{
if ( 0 == $length ) {
return '';
}
$text = wp_strip_all_tags( strip_shortcodes( $text ) );
if ( function_exists( 'mb_strlen' ) ) {
if ( mb_strlen( $text ) > $length ) {
return mb_substr( $text, 0, $length ) . '...';
}
return $text;
}
if ( strlen( $text ) > $length ) {
return substr( $text, 0, $length ) . '...';
}
return $text;
}
/**
* Function to check th options to show the thumbnails according to the post types, categories etc.
*
* @return boolean
* @version 6.0.0
*/
public function is_relpoststh_show()
{
// Checking display options
if ( ! is_single() && rpt_settings_bool( 'general.single_only', true ) ) { // single only
return false;
}
// Check post type
$post_types = (array) rpt_settings()->rpt_get( 'general.post_types', $this->post_types );
$post_type = get_post_type();
if (!is_array($post_types) || !in_array($post_type, $post_types, true)) {
return false;
}
// Check categories
$id = get_the_ID();
$query_scope = rpt_settings()->rpt_get( 'general.query_scope', array( 'mode' => 'all', 'category_ids' => array() ) );
$categories_all = rpt_settings_scope_is_all( $query_scope ) ? '1' : '0';
if ( '1' !== $categories_all ) { // only specific categories were selected
$post_categories = wp_get_object_terms($id, array('category'), array('fields' => 'ids'));
$relpoststh_categories = rpt_settings_scope_ids( $query_scope );
if (!is_array($relpoststh_categories) || !is_array($post_categories)) { // no categories were selcted or post doesn't belong to any
return false;
}
$common_categories = array_intersect($relpoststh_categories, $post_categories);
if (empty($common_categories)) { // post doesn't belong to specified categories
return false;
}
}
return true;
}
/**
* Clear related ID cache when a post is saved.
*
* @param int $post_id Post ID.
* @return void
* @since 5.0.0
* @version 6.0.0
*/
public function rpt_invalidate_post_cache_on_save( $post_id ) {
if ( ! rpt_is_related_cache_enabled() ) {
return;
}
if ( wp_is_post_revision( $post_id ) || wp_is_post_autosave( $post_id ) ) {
return;
}
rpt_delete_post_related_cache( $post_id );
}
/**
* Clear related ID cache when a post is trashed or deleted.
*
* @param int $post_id Post ID.
* @return void
* @since 5.0.0
* @version 6.0.0
*/
public function rpt_invalidate_post_cache_on_delete( $post_id ) {
if ( ! rpt_is_related_cache_enabled() ) {
return;
}
rpt_delete_post_related_cache( $post_id );
}
/**
* Add purge cache link to the admin bar.
*
* @param WP_Admin_Bar $admin_bar Admin bar instance.
* @return void
* @since 5.0.0
* @version 6.0.0
*/
public function rpt_admin_bar_cache_purge( $admin_bar ) {
if ( ! is_user_logged_in() || ! current_user_can( 'manage_options' ) || ! rpt_is_related_cache_enabled() ) {
return;
}
$admin_bar->add_node(
array(
'id' => 'rpt-purge-cache',
'title' => sprintf(
'%s',
esc_html__( 'Purge RPT Cache', 'related-posts-thumbnails' )
),
'href' => wp_nonce_url(
admin_url( 'admin-post.php?action=rpt_purge_cache' ),
'rpt_purge_cache'
),
'meta' => array(
'title' => esc_attr__( 'Purge RPT Cache', 'related-posts-thumbnails' ),
),
)
);
}
/**
* Enqueue admin bar icon styles for the purge cache link.
*
* @return void
* @since 5.0.0
* @version 6.0.0
*/
public function rpt_admin_bar_styles() {
if ( ! is_admin_bar_showing() || ! is_user_logged_in() || ! current_user_can( 'manage_options' ) || ! rpt_is_related_cache_enabled() ) {
return;
}
$icon_url = esc_url( plugin_dir_url( __FILE__ ) . 'img/rpt-menu-icon.svg' );
$css = '#wpadminbar #wp-admin-bar-rpt-purge-cache > .ab-item .ab-icon:before {
background: url("' . $icon_url . '") center / contain no-repeat;
content: "";
display: block;
float: left;
height: 20px;
margin: 3px 0 0;
width: 20px;
}';
wp_enqueue_style( 'admin-bar', false, array(), RELATED_POSTS_THUMBNAILS_VERSION );
wp_add_inline_style( 'admin-bar', $css );
}
/**
* Handle admin bar cache purge requests.
*
* @return void
* @since 5.0.0
* @version 6.0.0
*/
public function rpt_handle_admin_purge_cache() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( esc_html__( 'No access', 'related-posts-thumbnails' ) );
}
check_admin_referer( 'rpt_purge_cache' );
rpt_purge_all_related_cache();
$redirect = wp_get_referer();
if ( ! $redirect ) {
$redirect = admin_url( RELATED_POSTS_THUMBNAILS_ADMIN_URL_PATH );
}
wp_safe_redirect( add_query_arg( 'rpt_cache_purged', '1', $redirect ) );
exit;
}
/**
* Show cache purge notices in admin.
*
* @return void
* @since 5.0.0
* @version 6.0.0
*/
public function rpt_cache_purge_admin_notice() {
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
if ( isset( $_GET['rpt_cache_purged'] ) && '1' === sanitize_text_field( wp_unslash( (string) $_GET['rpt_cache_purged'] ) ) ) {
$pending = '1' === get_option( RPT_CACHE_PURGE_PENDING_OPTION, '0' );
$message = $pending
? esc_html__( 'Related posts cache purge started. Cleanup will continue in the background.', 'related-posts-thumbnails' )
: esc_html__( 'Related posts cache purged successfully.', 'related-posts-thumbnails' );
echo '';
}
}
/**
* Admin Menu page
*
* @return void
* @version 6.0.0
*/
public function admin_menu() {
add_menu_page(
__( 'Related Posts Thumbnails', 'related-posts-thumbnails' ),
__( 'Related Posts', 'related-posts-thumbnails' ),
'manage_options',
'related-posts-thumbnails',
array( $this, 'admin_interface' ),
plugin_dir_url( __FILE__ ) . 'img/rpt-menu-icon.svg'
);
add_submenu_page(
'related-posts-thumbnails',
__( 'Activate', 'related-posts-thumbnails' ),
' ',
'manage_options',
'rpt-optin',
array( $this, 'render_optin' )
);
add_action( 'admin_head', array( $this, 'admin_menu_css' ) );
}
/**
* Admin menu CSS.
*
* @return void
* @version 6.0.0
*/
public function admin_menu_css() {
?>
ID ) ) {
$post_id = $post->ID;
} elseif ( is_numeric( $post ) ) {
$post_id = intval( $post );
} else {
$post_id = 0;
}
if ( ! $show_category || $post_id === 0 ) {
return '';
}
if ( is_array( $taxonomies ) && isset( $taxonomies[0] ) ) {
return $this->relpoststh_category_list( $post_id, $taxonomies[0], $post_type );
}
// Add missing return statement
return '';
}
/**
* Related post thumbnail settings page load
*
* @return void
* @version 6.0.0
*/
public function admin_interface()
{
include_once RELATED_POSTS_THUMBNAILS_PLUGIN_DIR . '/inc/rpt-settings.php';
}
/**
* Category List in Settings
*
* @param $categoriesall
* @param $categories
* @param $selected_categories
* @param $all_name
* @param $specific_name
* @version 6.0.0
*/
public function display_categories_list($categoriesall, $categories, $selected_categories, $all_name, $specific_name)
{ ?>
/>
style="display:none"
>
rpt_maybe_fix_default_image_path();
$rpt_settings_service = new RPT_Settings_Service( $related_posts_thumbnails );
$rpt_rest_api = new RPT_REST_API( $rpt_settings_service );
$rpt_rest_api->init();
// Include frontend assets handler.
include_once plugin_dir_path( __FILE__ ) . 'inc/rpt-assets.php';
RPT_Frontend_Assets::rpt_init();
// Include Widget File.
include_once plugin_dir_path(__FILE__) . 'inc/rpt-widget.php';
// Include Blocks File.
include_once plugin_dir_path(__FILE__) . 'inc/rpt-blocks.php';
?>
 ); ?>){kind=logo}