ElasticPress Content Connect

ElasticPress Content Connect is a WordPress plugin that integrates Content Connect relationships with ElasticPress.

Features

Post to Post Relationships

Filter by Content Connect post-to-post relationships.

• Advanced Filtering: Filter search results by Content Connect post-to-post relationships
• Flexible Query Types: Support for ID-based, slug-based, and title-based filtering
• Real-time Indexing: Automatically indexes relationships when they're created or modified
• Performance Optimized: Uses Elasticsearch nested queries for efficient relationship lookups

Requirements

• PHP 7.4+
• WordPress 6.5
• ElasticPress
• Content Connect
• Elasticsearch per ElasticPress requirements

Installation

Manual Installation

1. Download the plugin ZIP file from the GitHub repository.
2. Go to Plugins > Add New > Upload Plugin in your WordPress admin area.
3. Upload the ZIP file and click Install Now.
4. Activate the plugin.

Install with Composer

To include this plugin as a dependency in your Composer-managed WordPress project:

1. Add the plugin to your project using the following command:

composer require s3rgiosan/elasticpress-content-connect

2. Run composer install to install the plugin.
3. Activate the plugin from your WordPress admin area or using WP-CLI.

Setup

1. Navigate to "ElasticPress" > "Features".
2. Enable "Post to Post Relationships" (see the Features section for more).
3. Click "Save and sync now" or "Save and sync later" (sync is required for the feature to work).

Advanced Setup

Filter Names

Change the URL parameter names for filters:

add_filter( 'ep_content_connect_post_to_post_relationship_filter_name', function( $filter_name, $relationship_name, $post_type ) {
    if ( $relationship_name === 'post-to-product' ) {
        return 'related-product'; // Use ?related-product=123 instead of ?product=123
    }
    return $filter_name;
}, 10, 3 );

Field Names

Customize Elasticsearch field names:

add_filter( 'ep_content_connect_field_name', function( $field_name, $relationship_name, $post_type ) {
    return $relationship_name . '_' . $post_type . '_relationships';
}, 10, 3 );

Field Values

Add extra data to indexed relationships:

add_filter( 'ep_content_connect_field_value', function( $field_value, $post ) {
    $field_value['custom_field'] = get_post_meta( $post->ID, 'custom_field', true );
    return $field_value;
}, 10, 2 );

Related Posts Query Args

// Adjust maximum related posts per relationship
add_filter( 'ep_content_connect_related_posts_query_args', function( $args, $post_id, $relationship_name ) {
    $args['posts_per_page'] = 150; // Default is 100
    return $args;
}, 10, 3 );

Filterable Pages

Enable filtering on custom pages:

add_filter( 'ep_content_connect_is_filterable_page', function( $is_filterable, $query ) {
    if ( $query->is_page() && is_page( 'special-archive' ) ) {
        return true;
    }
    return $is_filterable;
}, 10, 2 );

Elasticsearch Mapping

The plugin automatically creates nested field mappings:

{
  "post_to_product": {
    "type": "nested",
    "properties": {
      "post_id": { "type": "integer" },
      "post_title": {
        "type": "text",
        "fields": {
          "raw": { "type": "keyword" }
        }
      },
      "post_type": { "type": "keyword" },
      "post_name": { "type": "keyword" }
    }
  }
}

add_filter( 'ep_content_connect_post_to_post_relationships_field_mapping', function( $mapping ) {
    $field_mapping['properties']['custom_field'] = [ 'type' => 'keyword' ];
    return $mapping;
} );

Hooks Reference

Filters

Relationship Data:

• ep_content_connect_post_to_post_relationships - Modify available relationships
• ep_content_connect_related_post_types - Modify related post types
• ep_content_connect_field_name - Customize field names
• ep_content_connect_field_value - Customize field values

Query Filtering:

• ep_content_connect_is_filterable_page - Control which pages support filtering
• ep_content_connect_post_to_post_relationship_filter_name - Customize URL parameter names
• ep_content_connect_post_to_post_relationship_filter_value - Sanitize filter values
• ep_content_connect_post_to_post_relationship_filter_queries - Modify Elasticsearch queries

Performance:

• ep_content_connect_related_posts_query_args - Optimize relationship queries

Changelog

A complete listing of all notable changes to this project are documented in CHANGELOG.md.