feat: keyword-based filtering for post sharing

Add the ability to filter posts for automatic sharing by keywords in the post
title or content, in addition to taxonomies. A global field is available under
General Settings (Free/Starter); in Pro the filter is configured per account in
the post-format panel, mirroring how taxonomy filtering works. An Exclude toggle
switches between skipping matching posts and sharing only matching posts. The
match is applied as a scoped posts_where clause and is inactive when empty.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: vytisbulkevicius

assets/js/build/dashboard.js

@@ -179,6 +179,8 @@ class Rop_Global_Settings {
 		'available_taxonomies'  => array(),
 		'selected_taxonomies'   => array(),
 		'exclude_taxonomies'    => false,
+		'keyword_filter'        => '',
+		'exclude_keywords'      => true,
 		'available_posts'       => array(), // get_posts(),
 		'selected_posts'        => array(),
 		'exclude_posts'         => true,
@@ -666,11 +668,24 @@ public function license_type() {
 	 * @return array|mixed
 	 */
 	public function get_default_post_format( $service_name = false ) {
+		// Per-account keyword filter defaults, added to every service post format.
+		$keyword_defaults = array(
+			'keyword_filter'   => '',
+			'exclude_keywords' => true,
+		);
+
 		if ( isset( $service_name ) && $service_name != false && isset( self::instance()->post_format[ $service_name ] ) ) {
-			return self::instance()->post_format[ $service_name ];
+			return array_merge( $keyword_defaults, self::instance()->post_format[ $service_name ] );
+		}
+
+		$formats = self::instance()->post_format;
+		foreach ( $formats as $service => $format ) {
+			if ( is_array( $format ) ) {
+				$formats[ $service ] = array_merge( $keyword_defaults, $format );
+			}
 		}
 
-		return self::instance()->post_format;
+		return $formats;
 	}
 
 	/**

includes/admin/class-rop-global-settings.php

@@ -50,6 +50,18 @@ class Rop_Posts_Selector_Model extends Rop_Model_Abstract {
 	 */
 	private $settings = array();
 
+	/**
+	 * Per-account keyword filter override taken from the account post format.
+	 *
+	 * Null means "no per-account override" — the global keyword filter applies.
+	 * Set per call to select() so it never leaks between accounts.
+	 *
+	 * @since   9.3.7
+	 * @access  private
+	 * @var     array|null
+	 */
+	private $post_format_keyword_override = null;
+
 	/**
 	 * Rop_Posts_Selector_Model constructor.
 	 *
@@ -344,6 +356,9 @@ public function select( $account_id = false ) {
 		$post_types      = $this->build_post_types();
 		$global_settings = new Rop_Global_Settings();
 
+		// Reset per-account overrides so they never leak between accounts.
+		$this->post_format_keyword_override = null;
+
 		// Taxonomy: Post Format new option
 		if ( $global_settings->license_type() > 0 && $global_settings->license_type() !== 7 && ! empty( $account_id ) ) {
 			$parts             = explode( '_', $account_id );
@@ -369,6 +384,17 @@ public function select( $account_id = false ) {
 			}
 
 			$tax_queries = $this->build_tax_query( $custom_data );
+
+			// Per-account keyword filter (overrides the global one when set).
+			if ( isset( $post_format['keyword_filter'] ) && '' !== trim( (string) $post_format['keyword_filter'] ) ) {
+				$keywords = Rop_Settings_Model::parse_keyword_string( $post_format['keyword_filter'] );
+				if ( ! empty( $keywords ) ) {
+					$this->post_format_keyword_override = array(
+						'keywords' => $keywords,
+						'exclude'  => isset( $post_format['exclude_keywords'] ) ? filter_var( $post_format['exclude_keywords'], FILTER_VALIDATE_BOOLEAN ) : true,
+					);
+				}
+			}
 		} else {
 			$tax_queries = $this->build_tax_query();
 		}
@@ -459,8 +485,35 @@ private function query_results( $account_id, $post_types, $tax_queries, $exclude
 			$exclude = array();
 		}
 
-		$args  = $this->build_query_args( $post_types, $tax_queries, $exclude );
+		$args = $this->build_query_args( $post_types, $tax_queries, $exclude );
+
+		/**
+		 * Optional keyword filtering on post title/content. Only active when the
+		 * user has entered keywords; otherwise the query is untouched. A per-account
+		 * (post format) filter takes precedence over the global one. The filter is
+		 * added only around this query and guarded by a custom query var so no other
+		 * query is ever affected.
+		 */
+		if ( is_array( $this->post_format_keyword_override ) ) {
+			$keywords        = $this->post_format_keyword_override['keywords'];
+			$exclude_keyword = ! empty( $this->post_format_keyword_override['exclude'] );
+		} else {
+			$keywords        = $this->settings->get_keyword_filter();
+			$exclude_keyword = $this->settings->get_exclude_keywords();
+		}
+		if ( ! empty( $keywords ) ) {
+			$args['rop_keyword_filter'] = array(
+				'keywords' => $keywords,
+				'exclude'  => $exclude_keyword,
+			);
+			add_filter( 'posts_where', array( $this, 'filter_keyword_where' ), 10, 2 );
+		}
+
 		$query = new WP_Query( $args );
+
+		if ( ! empty( $keywords ) ) {
+			remove_filter( 'posts_where', array( $this, 'filter_keyword_where' ), 10 );
+		}
 		// echo $query->request;
 		$posts = $query->posts;
 
@@ -594,6 +647,46 @@ private function build_query_args( $post_types, $tax_queries, $exclude ) {
 		return $args;
 	}
 
+	/**
+	 * Append a keyword condition to the posts query WHERE clause.
+	 *
+	 * Hooked on `posts_where` only while the selector query runs. It acts solely
+	 * on queries carrying the `rop_keyword_filter` query var, matching the
+	 * keywords against the post title or content. In exclude mode posts matching
+	 * any keyword are removed; in include mode only matching posts are kept.
+	 *
+	 * @since   9.3.7
+	 * @access  public
+	 *
+	 * @param string   $where The WHERE clause of the query.
+	 * @param WP_Query $query The current WP_Query instance.
+	 *
+	 * @return string
+	 */
+	public function filter_keyword_where( $where, $query ) {
+		global $wpdb;
+
+		$config = $query->get( 'rop_keyword_filter' );
+		if ( empty( $config ) || empty( $config['keywords'] ) || ! is_array( $config['keywords'] ) ) {
+			return $where;
+		}
+
+		$clauses = array();
+		foreach ( $config['keywords'] as $keyword ) {
+			$like      = '%' . $wpdb->esc_like( $keyword ) . '%';
+			$clauses[] = $wpdb->prepare( "({$wpdb->posts}.post_title LIKE %s OR {$wpdb->posts}.post_content LIKE %s)", $like, $like );
+		}
+
+		if ( empty( $clauses ) ) {
+			return $where;
+		}
+
+		$group = '( ' . implode( ' OR ', $clauses ) . ' )';
+		$where .= ! empty( $config['exclude'] ) ? " AND NOT {$group}" : " AND {$group}";
+
+		return $where;
+	}
+
 	/**
 	 * Method to determine if the buffer is empty or not.
 	 *

includes/admin/models/class-rop-posts-selector-model.php

@@ -306,6 +306,62 @@ public function get_exclude_taxonomies() {
 		return $this->settings['exclude_taxonomies'];
 	}
 
+	/**
+	 * Getter for the keyword filter list.
+	 *
+	 * Returns the user supplied keywords as a clean, de-duplicated array.
+	 * An empty array means the feature is inactive.
+	 *
+	 * @since   9.3.7
+	 * @access  public
+	 * @return  array
+	 */
+	public function get_keyword_filter() {
+		$raw = isset( $this->settings['keyword_filter'] ) ? $this->settings['keyword_filter'] : '';
+
+		return self::parse_keyword_string( $raw );
+	}
+
+	/**
+	 * Parse a comma separated keyword string into a clean, de-duplicated array.
+	 *
+	 * Shared by the global keyword filter and the per-account (post format) one.
+	 *
+	 * @since   9.3.7
+	 * @access  public
+	 *
+	 * @param  string $raw The raw comma separated keywords.
+	 * @return array
+	 */
+	public static function parse_keyword_string( $raw ) {
+		if ( ! is_string( $raw ) || '' === trim( $raw ) ) {
+			return array();
+		}
+		$keywords = array_map( 'trim', explode( ',', $raw ) );
+		$keywords = array_filter(
+			$keywords,
+			function ( $keyword ) {
+				return '' !== $keyword;
+			}
+		);
+
+		return array_values( array_unique( $keywords ) );
+	}
+
+	/**
+	 * Getter for the keyword filter mode.
+	 *
+	 * When true, posts matching the keywords are excluded from sharing;
+	 * when false, only posts matching the keywords are shared.
+	 *
+	 * @since   9.3.7
+	 * @access  public
+	 * @return  bool
+	 */
+	public function get_exclude_keywords() {
+		return ! empty( $this->settings['exclude_keywords'] );
+	}
+
 	/**
 	 * Add one post or a list of posts to the excluded posts list.
 	 *
@@ -469,6 +525,14 @@ private function validate_settings( $data ) {
 			}
 		}
 
+		if ( isset( $data['keyword_filter'] ) ) {
+			$data['keyword_filter'] = sanitize_text_field( $data['keyword_filter'] );
+		}
+
+		if ( isset( $data['exclude_keywords'] ) ) {
+			$data['exclude_keywords'] = (bool) $data['exclude_keywords'];
+		}
+
 		return $data;
 	}
 

includes/admin/models/class-rop-settings-model.php

@@ -179,6 +179,13 @@ public static function get_labels( $key = '' ) {
 				),
 				'filter_by_taxonomies_desc'     => __( 'Filter posts list by Taxonomy', 'tweet-old-post' ),
 				'taxonomies_exclude'          => __( 'Exclude?', 'tweet-old-post' ),
+				'keyword_filter_title'        => __( 'Keyword Filtering', 'tweet-old-post' ),
+				'keyword_filter_desc'         => __(
+					'Comma-separated words or phrases matched against the post title and content. Use the toggle to either exclude matching posts from sharing, or share only matching posts.',
+					'tweet-old-post'
+				),
+				'keyword_filter_placeholder'  => __( 'e.g. sponsored, internal, draft review', 'tweet-old-post' ),
+				'keyword_filter_exclude'      => __( 'Exclude?', 'tweet-old-post' ),
 				'posts_title'                 => __( 'Posts', 'tweet-old-post' ),
 				'posts_desc'                  => __( 'Posts excluded from sharing, filtered based on previous selections.', 'tweet-old-post' ),
 				'ga_title'                    => __( 'Enable Google Analytics Tracking', 'tweet-old-post' ),

includes/class-rop-i18n.php

@@ -445,6 +445,39 @@
         </div>
       </div>
     </div>
+    <!-- Per-account keyword filtering. Disabled (upsell) outside Pro, like taxonomies above. -->
+    <div
+      class="columns py-2"
+      :class="'rop-control-container-'+(isPro && (license_price_id !== 7))"
+    >
+      <div class="column col-6 col-sm-12 vertical-align rop-control">
+        <b>{{ labels_settings.keyword_filter_title }}</b>
+        <p class="text-gray">
+          <span v-html="labels_settings.keyword_filter_desc" />
+        </p>
+      </div>
+      <div class="column col-6 col-sm-12 vertical-align">
+        <div class="input-group">
+          <input
+            v-model="post_format.keyword_filter"
+            :disabled="!isPro || (license_price_id === 7)"
+            type="text"
+            class="form-input"
+            :placeholder="labels_settings.keyword_filter_placeholder"
+          >
+          <span class="input-group-addon vertical-align">
+            <label class="form-checkbox">
+              <input
+                v-model="post_format.exclude_keywords"
+                :disabled="!isPro || (license_price_id === 7)"
+                type="checkbox"
+              >
+              <i class="form-icon" />{{ labels_settings.keyword_filter_exclude }}
+            </label>
+          </span>
+        </div>
+      </div>
+    </div>
     <div
       v-if="!isPro || (license_price_id === 7)"
       class="columns "

vue/src/vue-elements/post-format.vue

@@ -275,6 +275,46 @@
 
         <span class="divider" />
 
+        <!-- Keyword Filtering (global). In Pro this moves to per-account settings. -->
+        <div
+          v-if="!isPro || license_price_id === 7"
+          class="columns py-2"
+        >
+          <div class="column col-6 col-sm-12 vertical-align">
+            <b>{{ labels.keyword_filter_title }}</b>
+            <p class="text-gray">
+              <span v-html="labels.keyword_filter_desc" />
+            </p>
+          </div>
+          <div
+            id="rop_keyword_filter"
+            class="column col-6 col-sm-12 vertical-align text-left"
+          >
+            <div class="input-group">
+              <input
+                v-model="generalSettings.keyword_filter"
+                type="text"
+                class="form-input"
+                :placeholder="labels.keyword_filter_placeholder"
+              >
+              <span class="input-group-addon vertical-align">
+                <label class="form-checkbox">
+                  <input
+                    v-model="generalSettings.exclude_keywords"
+                    type="checkbox"
+                  >
+                  <i class="form-icon" />{{ labels.keyword_filter_exclude }}
+                </label>
+              </span>
+            </div>
+          </div>
+        </div>
+
+        <span
+          v-if="!isPro || license_price_id === 7"
+          class="divider"
+        />
+
         <!-- Update publish date -->
         <div
           class="columns py-2"
@@ -746,6 +786,8 @@
           selected_post_types: postTypesSelected,
           selected_taxonomies: taxonomiesSelected,
           exclude_taxonomies: excludeTaxonomies,
+          keyword_filter: this.generalSettings.keyword_filter,
+          exclude_keywords: this.generalSettings.exclude_keywords,
           update_post_published_date: this.generalSettings.update_post_published_date,
           ga_tracking: this.generalSettings.ga_tracking,
           custom_messages: this.generalSettings.custom_messages,