Search API Sitestudio Processor

This project provides an Search API processor for Drupal websites that rely on Acquia Site Studio for content creation and needs to index directly the content from the Site Studio components instead of rendering them and retrieve the HTML generated.

Features

When you use the powerful drag-and-drop interface of Acquia Site Studio to build pages—inserting text fields, customising components, and designing complex layouts—the content is often saved in a way that Drupal's standard search tools struggle to understand and if you use the "Render HTML Output" processor to render the components directly, you may run into performance issues if your site uses a lot of images and especially if you use a DAM service due to the API calls to retrieve the URLs of the images or other assets informations.

The core function of this module is to act as a specialised translator for your search engine. It introduces a new Search API Processor designed specifically to decode the complex data structure created by Site Studio components.

The processor is fully customisable and you can choose to index all Site Studio components, or precisely filter by component category or single component for accurate, controlled search results.

Post-Installation

Once this module is installed, you must perform a few quick steps within the Search API settings to start indexing your Acquia Site Studio content.

1. Add the Index Field: Navigate to the configuration page for your chosen Search API index. You must add a new field to the index and name it "Sitestudio Components". This field serves as the anchor point for the processor to inject the decoded Site Studio content.
2. Configure the field with the available configuration.

Special Configuration Considerations

• Default Behavior (All Components): By default, the processor is configured to index all text content it finds within every Site Studio component on the page. This is the simplest way to ensure comprehensive search coverage.
• Advanced Filtering for Control: If you need to refine what content is indexed—for instance, to keep your search index smaller or to exclude certain decorative components—you can adjust the processor's configuration. This allows you to set precise rules:
• Filter by Component Category: Only index content from specific groups of components (e.g., "Basic components" but not "Layout component").
• Filter by Single Component: Only index content from a specific component (e.g., only the "Text" component).

This ability to filter gives you granular control over what appears in your site's search results, ensuring maximum relevance.

Additional Requirements

Search API module