338 lines
11 KiB
PHP
338 lines
11 KiB
PHP
|
|
<?php
|
||
|
|
|
||
|
|
/**
|
||
|
|
* This file contains all functions relating to the blacklisting of
|
||
|
|
* imported feeds items.
|
||
|
|
*
|
||
|
|
* Blacklisting a feed item is in essence nothing more than a saved list
|
||
|
|
* of feed items. When a feed item is imported, its normalized permalink
|
||
|
|
* is tested against this list, and if found, the feed item is not
|
||
|
|
* imported. Admins can add items to the blacklist, to prevent them
|
||
|
|
* from being imported again.
|
||
|
|
*
|
||
|
|
* @package WP RSS Aggregator
|
||
|
|
* @since 4.4
|
||
|
|
*/
|
||
|
|
|
||
|
|
// Check if the 'blacklist' GET param is set
|
||
|
|
add_action( 'admin_init', 'wprss_check_if_blacklist_item' );
|
||
|
|
// Checks if the transient is set to show the notice
|
||
|
|
add_action( 'admin_init', 'wprss_check_notice_transient' );
|
||
|
|
// Register custom post type
|
||
|
|
// Add the row actions to the targetted post type
|
||
|
|
add_filter( 'post_row_actions', 'wprss_blacklist_row_actions', 10, 1 );
|
||
|
|
// Check if deleting a blacklist item, from the GET parameter
|
||
|
|
add_action( 'admin_init', 'wprss_check_if_blacklist_delete' );
|
||
|
|
// Changes the wprss_blacklist table columns
|
||
|
|
add_filter( 'manage_wprss_blacklist_posts_columns', 'wprss_blacklist_columns');
|
||
|
|
// Prints the table data for each blacklist entry
|
||
|
|
add_action( 'manage_wprss_blacklist_posts_custom_column' , 'wprss_blacklist_table_contents', 10, 2 );
|
||
|
|
// Changes the wprss_blacklist bulk actions
|
||
|
|
add_filter('bulk_actions-edit-wprss_blacklist','wprss_blacklist_bulk_actions', 5, 1 );
|
||
|
|
// Adds the metabox to the blacklist new/edit page
|
||
|
|
add_action('add_meta_boxes_wprss_blacklist', 'wprss_blacklist_add_meta_boxes');
|
||
|
|
|
||
|
|
// Disables auto saving
|
||
|
|
add_action( 'admin_enqueue_scripts', function () {
|
||
|
|
if (get_post_type() === 'wprss_blacklist') {
|
||
|
|
wp_dequeue_script('autosave');
|
||
|
|
}
|
||
|
|
});
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Retrieves the blacklisted items.
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
* @return array An associative array of blacklisted item, each entry
|
||
|
|
* having the key as the permalink, and the value as the title.
|
||
|
|
*/
|
||
|
|
function wprss_get_blacklist() {
|
||
|
|
// Get the option
|
||
|
|
$blacklist_option = get_option('wprss_blacklist');
|
||
|
|
// If the option does not exist
|
||
|
|
if ( $blacklist_option === FALSE || !is_array( $blacklist_option ) ) {
|
||
|
|
// create it
|
||
|
|
update_option( 'wprss_blacklist', array() );
|
||
|
|
$blacklist_option = array();
|
||
|
|
}
|
||
|
|
return $blacklist_option;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Creates a blacklist entry for the given feed item.
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
* @param int|string The ID of the feed item to add to the blacklist
|
||
|
|
*/
|
||
|
|
function wprss_blacklist_item( $ID ) {
|
||
|
|
// Return if feed item is null
|
||
|
|
if ( is_null( $ID ) ) return;
|
||
|
|
|
||
|
|
// Get the feed item data
|
||
|
|
$item_title = get_the_title( $ID );
|
||
|
|
$item_permalink = get_post_meta( $ID, 'wprss_item_permalink', TRUE );
|
||
|
|
// If not an imported item, stop
|
||
|
|
if ( $item_permalink === '' ) {
|
||
|
|
wpra_get_logger()->warning('Feed item with ID {0} was not blacklisted because its URL was empty', [$ID]);
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
// Prepare the data for blacklisting
|
||
|
|
$title = apply_filters( 'wprss_blacklist_title', trim( $item_title ) );
|
||
|
|
$permalink = apply_filters( 'wprss_blacklist_permalink', trim( $item_permalink ) );
|
||
|
|
|
||
|
|
// Get the blacklisted items
|
||
|
|
$blacklist = wprss_get_blacklist();
|
||
|
|
// Add the item to the blacklist
|
||
|
|
$blacklist[ $permalink ] = $title;
|
||
|
|
|
||
|
|
// Delete the item
|
||
|
|
wp_delete_post( $ID, TRUE );
|
||
|
|
|
||
|
|
// Add the blacklisted item
|
||
|
|
$id = wp_insert_post(array(
|
||
|
|
'post_title' => $title,
|
||
|
|
'post_type' => 'wprss_blacklist',
|
||
|
|
'post_status' => 'publish'
|
||
|
|
));
|
||
|
|
update_post_meta( $id, 'wprss_permalink', $permalink );
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Determines whether the given item is blacklist.
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
* @param string $permalink The permalink to look for in the saved option
|
||
|
|
* @return bool TRUE if the permalink is found, FALSE otherwise.
|
||
|
|
*/
|
||
|
|
function wprss_is_blacklisted( $permalink ) {
|
||
|
|
if (empty($permalink)) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Query the blacklist entries, for an item with the given permalink
|
||
|
|
$query = new WP_Query(array(
|
||
|
|
'post_type' => 'wprss_blacklist',
|
||
|
|
'meta_key' => 'wprss_permalink',
|
||
|
|
'meta_value' => $permalink
|
||
|
|
));
|
||
|
|
|
||
|
|
// Return TRUE if the query returned a result, FALSE otherwise
|
||
|
|
return $query->have_posts();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Check if the 'blacklist' GET param is set, and prepare to blacklist the item.
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
*/
|
||
|
|
function wprss_check_if_blacklist_item() {
|
||
|
|
// If the GET param is not set, do nothing. Return.
|
||
|
|
if ( empty( $_GET['wprss_blacklist'] ) ) return;
|
||
|
|
|
||
|
|
// Get the ID from the GET param
|
||
|
|
$ID = $_GET['wprss_blacklist'];
|
||
|
|
// If the post does not exist, stop. Show a message
|
||
|
|
if ( get_post($ID) === NULL ) {
|
||
|
|
wp_die( __( 'The item you are trying to blacklist does not exist', WPRSS_TEXT_DOMAIN ) );
|
||
|
|
}
|
||
|
|
|
||
|
|
// If the post type is not correct,
|
||
|
|
if ( get_post_meta( $ID, 'wprss_item_permalink', TRUE ) === '' || get_post_status( $ID ) !== 'trash' ) {
|
||
|
|
wp_die( __( 'The item you are trying to blacklist is not valid!', WPRSS_TEXT_DOMAIN ) );
|
||
|
|
}
|
||
|
|
|
||
|
|
check_admin_referer( 'blacklist-item-' . $ID, 'wprss_blacklist_item' );
|
||
|
|
wprss_blacklist_item( $ID );
|
||
|
|
|
||
|
|
// Get the current post type for the current page
|
||
|
|
$post_type = isset( $_GET['post_type'] )? $_GET['post_type'] : 'post';
|
||
|
|
// Check the current page, and generate the URL query string for the page
|
||
|
|
$paged = isset( $_GET['paged'] )? '&paged=' . $_GET['paged'] : '';
|
||
|
|
// Set the notice transient
|
||
|
|
set_transient( 'wprss_item_blacklist_notice', 'true' );
|
||
|
|
// Refresh the page without the GET parameter
|
||
|
|
wp_redirect( admin_url( "edit.php?post_type=$post_type&post_status=trash" . $paged ) );
|
||
|
|
exit();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks if the transient for the blacklist notice is set, and shows the notice
|
||
|
|
* if it is set.
|
||
|
|
*/
|
||
|
|
function wprss_check_notice_transient() {
|
||
|
|
// Check if the transient exists
|
||
|
|
$transient = get_transient( 'wprss_item_blacklist_notice' );
|
||
|
|
if ( $transient !== FALSE ) {
|
||
|
|
// Remove the transient
|
||
|
|
delete_transient( 'wprss_item_blacklist_notice' );
|
||
|
|
// Show the notice
|
||
|
|
// add_action( 'admin_notices', 'wprss_blacklist_item_notice' );
|
||
|
|
wprss()->getAdminAjaxNotices()->addNotice('blacklist_item_success');
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Adds the row actions to the targetted post type.
|
||
|
|
* Default post type = wprss_feed_item
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
* @param array $actions The row actions to be filtered
|
||
|
|
* @return array The new filtered row actions
|
||
|
|
*/
|
||
|
|
function wprss_blacklist_row_actions( $actions ) {
|
||
|
|
// Check the current page, and generate the URL query string for the page
|
||
|
|
$paged = isset( $_GET['paged'] )? '&paged=' . $_GET['paged'] : '';
|
||
|
|
|
||
|
|
|
||
|
|
// Check the post type
|
||
|
|
if ( get_post_status() == 'trash' ) {
|
||
|
|
// Get the Post ID
|
||
|
|
$ID = get_the_ID();
|
||
|
|
|
||
|
|
// Get the permalink. If does not exist, then it is not an imported item.
|
||
|
|
$permalink = get_post_meta( $ID, 'wprss_item_permalink', TRUE );
|
||
|
|
if ( $permalink === '' ) {
|
||
|
|
return $actions;
|
||
|
|
}
|
||
|
|
|
||
|
|
// The post type on the current screen
|
||
|
|
$post_type = get_post_type();
|
||
|
|
// Prepare the blacklist URL
|
||
|
|
$plain_url = apply_filters(
|
||
|
|
'wprss_blacklist_row_action_url',
|
||
|
|
admin_url( "edit.php?post_type=$post_type&wprss_blacklist=$ID" ),
|
||
|
|
$ID
|
||
|
|
) . $paged;
|
||
|
|
// Add a nonce to the URL
|
||
|
|
$nonced_url = wp_nonce_url( $plain_url, 'blacklist-item-' . $ID, 'wprss_blacklist_item' );
|
||
|
|
|
||
|
|
// Prepare the text
|
||
|
|
$text = apply_filters( 'wprss_blacklist_row_action_text', htmlentities( __( 'Delete Permanently & Blacklist', WPRSS_TEXT_DOMAIN ) ) );
|
||
|
|
$text = __( $text, WPRSS_TEXT_DOMAIN );
|
||
|
|
|
||
|
|
// Prepare the hint
|
||
|
|
$hint = apply_filters(
|
||
|
|
'wprss_blacklist_row_action_hint',
|
||
|
|
__( 'The item will be deleted permanently, and its permalink will be recorded in the blacklist', WPRSS_TEXT_DOMAIN )
|
||
|
|
);
|
||
|
|
$hint = esc_attr( __( $hint, WPRSS_TEXT_DOMAIN ) );
|
||
|
|
|
||
|
|
// Add the blacklist action
|
||
|
|
$actions['blacklist-item'] = "<span class='delete'><a title='$hint' href='$nonced_url'>$text</a></span>";
|
||
|
|
}
|
||
|
|
|
||
|
|
// For the blacklisted item
|
||
|
|
elseif ( get_post_type() === 'wprss_blacklist' ) {
|
||
|
|
$paged = isset( $_GET['paged'] )? '&paged=' . $_GET['paged'] : '';
|
||
|
|
$remove_url = wp_nonce_url( 'post.php?wprss-blacklist-remove='.get_the_ID(), 'blacklist-remove-' . get_the_ID(), 'wprss_blacklist_trash' );
|
||
|
|
$actions = array(
|
||
|
|
'edit' => $actions['edit'],
|
||
|
|
'trash' => '<a href="'.$remove_url.'">' . __( 'Remove From Blacklist', WPRSS_TEXT_DOMAIN ) . '</a>'
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
// Return the actions
|
||
|
|
return $actions;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks for the GET parameter wprss-blacklist-remove, and if present,
|
||
|
|
* deletes the appropriate blacklist entry. Uses nonce 'wprss_blacklist_trash'
|
||
|
|
* with action 'blacklist-remove-$ID'
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
*/
|
||
|
|
function wprss_check_if_blacklist_delete() {
|
||
|
|
// If the GET param is not set, do nothing. Return.
|
||
|
|
if ( !array_key_exists('wprss-blacklist-remove', $_GET) ) return;
|
||
|
|
|
||
|
|
// The array of blacklist entries to delete
|
||
|
|
$to_delete = array();
|
||
|
|
// The ID of the blacklist entry - if only deleting a single entry
|
||
|
|
$ID = $_GET['wprss-blacklist-remove'];
|
||
|
|
|
||
|
|
// check if deleting in bulk
|
||
|
|
if ( isset( $_GET['wprss-bulk'] ) && $_GET['wprss-bulk'] == '1' ) {
|
||
|
|
$to_delete = explode( ',', $ID );
|
||
|
|
check_admin_referer( 'blacklist-remove-selected', 'wprss_blacklist_trash' );
|
||
|
|
} else {
|
||
|
|
$to_delete = array( $ID );
|
||
|
|
// Get the ID from the GET param
|
||
|
|
// Verify the nonce
|
||
|
|
check_admin_referer( 'blacklist-remove-' . $ID, 'wprss_blacklist_trash' );
|
||
|
|
}
|
||
|
|
|
||
|
|
// Delete the posts marked for delete
|
||
|
|
foreach( $to_delete as $delete_id ) {
|
||
|
|
$post = get_post( $delete_id );
|
||
|
|
if ( $post === NULL || get_post_type( $post ) !== 'wprss_blacklist' ) continue;
|
||
|
|
wp_delete_post( $delete_id, TRUE );
|
||
|
|
}
|
||
|
|
|
||
|
|
// Redirect back to blacklists page
|
||
|
|
$paged = isset( $_GET['paged'] )? '&paged=' . $_GET['paged'] : '';
|
||
|
|
header('Location: ' . admin_url('edit.php?post_type=wprss_blacklist' . $paged ) );
|
||
|
|
exit;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the custom columns for the blacklist post type
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
* @params array $cols The columns to filter
|
||
|
|
* @return array The new columns
|
||
|
|
*/
|
||
|
|
function wprss_blacklist_columns( $cols ) {
|
||
|
|
return array(
|
||
|
|
'cb' => $cols['cb'],
|
||
|
|
'title' => __( 'Title' ),
|
||
|
|
'permalink' => __( 'URL' )
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Prints the cell data in the table for each blacklist entry
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
* @param string $column The column slug
|
||
|
|
* @param string|int $ID The ID of the post currently being printed
|
||
|
|
*/
|
||
|
|
function wprss_blacklist_table_contents( $column, $ID ) {
|
||
|
|
switch ( $column ) {
|
||
|
|
case 'permalink':
|
||
|
|
$permalink = get_post_meta( $ID, 'wprss_permalink', TRUE );
|
||
|
|
echo '<a href="'.$permalink.'" target="_blank">'.$permalink.'</a>';
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Removes the bulk actions for the Blacklist post type
|
||
|
|
*
|
||
|
|
* @since 4.4
|
||
|
|
* @param array $actions The array of actions to be filtered
|
||
|
|
* @return array An empty array
|
||
|
|
*/
|
||
|
|
function wprss_blacklist_bulk_actions( $actions ) {
|
||
|
|
return array();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Adds the permalink meta box for the Blacklist post type.
|
||
|
|
*
|
||
|
|
* @since 4.13
|
||
|
|
*/
|
||
|
|
function wprss_blacklist_add_meta_boxes()
|
||
|
|
{
|
||
|
|
add_meta_box(
|
||
|
|
'wprss-blacklist-permalink',
|
||
|
|
__('Details', 'wprss'),
|
||
|
|
function ($post) {
|
||
|
|
echo wpra_get('twig')->load('admin/blacklist-metabox.twig')->render([
|
||
|
|
'value' => $post->wprss_permalink
|
||
|
|
]);
|
||
|
|
},
|
||
|
|
'wprss_blacklist'
|
||
|
|
);
|
||
|
|
}
|