PS PrestaShop Intermediate

DF Faceted SEO — Faceted Search & SEO for PrestaShop

Indexing rules for filtered URLs and SEO landing pages, added on top of the filter engine in place, for PrestaShop 1.7.8, 8 and 9.

Updated Module version 2.0.0

DF Faceted SEO 2.0.0 decides how the filtered URLs of your product lists are indexed and serves landing pages that you write. It works on top of the faceted search engine already installed (usually ps_facetedsearch) without replacing it. Compatible with PrestaShop 1.7.8, 8 and 9, PHP 7.1 to 8.5.

What the module does

On categories, brands, suppliers, new products, prices drop and best sales, the module reads the filters chosen by the engine in place and decides, for each filtered URL:

  • the meta robots tag: index, or noindex,follow;
  • the canonical;
  • the hreflang tags (removed from filtered URLs, since no equivalent is guaranteed in other languages);
  • a 301 redirect to the normalized filter order;
  • optionally, a 404 response for a combination with no product.

It also serves landing pages: one page per commercial selection (category and filters), with a clean URL per language, an H1, a title, a meta description and a text written by you.

The module does not change robots.txt, .htaccess or friendly URLs. It creates no page automatically. It promises no traffic, no rankings and no indexing: search engines decide.

Requirements

  • PrestaShop 1.7.8 to 9.x, PHP 7.1 to 8.5.
  • A faceted search engine active on product lists: ps_facetedsearch, or any engine exposing the core’s standard facets.
  • Friendly URLs enabled for landing pages.

Installation

  1. Upload dffacetedseo-2.0.0.zip in Modules > Module Manager, then click Install.
  2. Open Improve > Faceted SEO > Dashboard.
  3. Read the Engine and coexistence and Alerts blocks.

After installation, no filtered URL is indexable: the default rule is noindex,follow with a canonical to the unfiltered list, as PrestaShop 9 already does.

Upgrading from 1.0.2

Make a backup, then upload the 2.0.0 zip from the module manager. The upgrade script runs on its own:

  • rules are converted (“canonical self” becomes indexable, “disallow” becomes noindex with its blacklist);
  • landing pages keep their IDs, slugs and the landing prefix;
  • statistics are kept;
  • page text is cleaned (scripts are removed);
  • empty tables, the Search Console key and old files are removed; the old AJAX endpoint answers 410.

Dashboard

Faceted SEO dashboard: key figures, detected engine, coexistence and alerts
Dashboard

The dashboard shows the key figures, the detected engine, the state of neighbouring modules and the alerts. Examples of alerts: the PrestaShop 9 robots.txt blocking ?q= while a rule opens combinations, a landing page without text, two pages on the same selection, settings to check in dfallinoneseo or datafireflyhreflang.

Settings

  • Listing mode: Automatic (paused when dffacetedfilter is active) by default, Always on or Off (landing pages only).
  • When no rule applies: noindex (recommended) by default.
  • Max facets combined (1) and Min products (3): limits applied by default.
  • Combination without products: noindex by default, or HTTP 404 (Google recommendation).
  • Facets never indexable: price, weight, availability, condition, extras and sub-category are ticked by default.
  • Filtered URL equal to a landing page: Canonical to the landing page by default, or 301 redirect to the landing page.
  • URL prefix: selection on a fresh install, landing kept after an upgrade. Changing the prefix keeps the former URLs as 301s.
  • Min words of unique text to be indexable (60) and Min products to be indexable (3).
  • Keep for (days): 180 days for statistics.
  • When the module is uninstalled: keep (default) or delete everything.

Sorted lists (?order=) and pages 2+ of filtered URLs are always noindex, with a canonical to the unsorted page. The noindex is written in the page: a URL blocked by robots.txt is not crawled, so its noindex is never read.

Indexation rules

Indexation rule editor: allowed facets, thresholds and values
Indexation rule

In Indexation rules, a rule applies to the whole shop or to a category, including its sub-categories if you tick it. For a filtered URL, the most specific active rule wins: the category’s rule, then the rule of the parent category covering its sub-categories, then the general rule. Priority breaks ties between two rules of the same scope.

With the May be indexed decision, the URL is indexable only if every condition is met:

  • Max facets combined: with 1, “Red” is indexable, “Red + 42” is not;
  • Max values per facet: with 1, “Red” is indexable, “Red or Blue” is not;
  • Min products;
  • Indexable facets (whitelist);
  • Only these values (optional) and Never these values;
  • first page only.

Otherwise the URL gets noindex,follow and a canonical to the unfiltered list. The Never indexed decision forces this result.

Open few combinations: those that match a real search of your customers and list enough products. Then check them in the simulator.

Simulator

Simulator: composed combination, indexation decision and checked steps
Indexation simulator

Simulator: would this URL be indexed, and why? uses the same decision function as the shop. In Compose a combination mode, choose a category and filters: the result shows the decision, the meta robots, the canonical, the product count, the rule applied and the steps checked.

Testing a real filtered URL: robots and canonical tags found in the HTML
Real URL test

In Test a real URL mode, paste the URL of a list or a landing page of the shop: the page is actually requested and the tags found in the HTML are shown. Several canonicals or several meta robots tags are flagged. Only the shop’s domains are accepted.

Landing pages

List and suggestions

Landing page list with indexing status, products, words and suggestions from popular combinations
Landing page list

Landing pages lists your pages with their status, product and word counts, and languages. The Suggestions from popular combinations block offers the combinations used at least 5 times, with enough products and no page yet. Create a draft pre-fills an inactive draft: you write the text and decide to publish. Export (JSON) and Import copy pages and rules from one shop to another; everything imported arrives as a draft or inactive.

Editor

Landing page editor with search result preview, product counter and checklist
Editor and SERP preview
  1. Product selection: category (or none), sub-categories included or not, filters of the selection. The number of matching products is shown live.
  2. Content and SEO by language: name, URL, H1 heading, Meta title, Meta description, introduction above the products and text below them. Leave the name empty to not publish a language (404, no hreflang).
  3. Search result preview: approximate preview, the search engine may rewrite the title and the description.
  4. Checklist (current language): title of 30 to 60 characters, description of 70 to 160 characters, unique text of at least 60 words, at least 3 products, no other page with the same selection.
  5. Publication: Online and Indexable (when the checklist is met).

HTML allowed in texts: paragraphs, subheadings, lists, links, bold and italics. Scripts, styles, forms and event attributes are removed on save and on display.

URLs and redirects

The URL follows the pattern /language/prefix/slug, for example:

https://your-shop.com/en/selection/leather-trail-shoes

Renaming the slug or changing the prefix keeps the old URL as a 301. A page that is disabled, deleted, missing in the language or whose category is inactive answers 404. A page that does not meet the checklist is served with noindex. Each pagination page has its own canonical.

In the shop

Landing page with H1 title, editorial text, refinement filters and products
Landing page

The theme displays the products, sorting and pagination. The module adds the Refine this selection block: color swatches, features, brands, price slider, counters, active filters as badges and Clear all.

Refining by colour swatch with the active filter shown as a badge and the list updated without reload
Refining with filters

The list updates without reloading, through the theme’s mechanism; the robots and canonical tags in the head follow. The structured breadcrumb (BreadcrumbList) is the theme’s: the module adds one only when the theme does not provide it.

Landing page on mobile with Filters button and product count
Landing page on mobile
Accessible mobile filter panel: colour swatches, checkboxes and counts
Filters on mobile

On mobile, filters open in an accessible panel: filter groups in fieldsets, result count announced to screen readers, focus kept and closing with Escape.

Internal linking

Links to the indexable landing pages at the bottom of their category
Internal linking

The Popular selections block at the bottom of a category links to its indexable landing pages. It can be turned off in the settings.

Popular filter combinations, counted anonymously, with the indexation decision
Popular combinations

Popular combinations lists the filter combinations chosen by visitors, with visit and product counts and the decision taken at the last visit. Create a draft opens a landing page draft from a row.

  • Data stored: combination, counter, product count, decision and dates. No IP address, no customer, no session, no user agent.
  • A browser is counted once per combination; known bots and direct hits without interaction are ignored.
  • Automatic purge after 180 days without a visit (configurable); the Purge button deletes earlier.

Sitemap and neighbouring modules

  • dfsitemap receives the indexable landing pages, one URL per language. Without dfsitemap, a sitemap is available at /module/dffacetedseo/sitemap.
  • dffacetedfilter: in automatic mode, listing rules pause because it already handles the SEO of its filtered URLs; landing pages stay active.
  • dfallinoneseo: if you open combinations, turn off its “noindex on faceted pages” and “faceted canonical” options. It keeps og:url on the unfiltered URL.
  • datafireflyhreflang: depending on its configuration, it may remove the hreflang tags of landing pages; the dashboard tells you.

Measured performance

PrestaShop 9.1.5 test shop in debug mode, 3,000 fictitious products, average of 20 requests:

Page Module disabled Module enabled
Category of 3,000 products 0.273 s 0.258 s
Filtered category (1,000 products) 0.240 s 0.242 s
Landing page of 1,000 products, cold / warm cache — 0.278 s / 0.211 s

On product lists the difference stays within measurement noise: the module runs no search there and claims no speed gain. The landing page engine runs 11 SQL queries whether the page lists 6 or 1,000 products.

Troubleshooting

A landing page answers 404

Check that the page is online, that its name is filled in this language, that its category is active and open to the visitor’s group, and that friendly URLs are enabled. Then clear the cache.

A landing page stays noindex

The checklist is not met (text under 60 words, fewer than 3 products) or the indexing box is unticked. The real URL test of the simulator gives the reason.

Rules have no effect on categories

dffacetedfilter is active in automatic mode, or the listing mode is set to Off (landing pages only). The dashboard says so.

Two canonicals in the page

Another module or the theme adds its own tag. The real URL test lists the tags found; turn off the matching option in the other module.

Uninstalling

The choice is made beforehand, in When the module is uninstalled: Keep landing pages, rules, redirects and statistics (reinstalling restores them), or Delete everything (landing page URLs will answer 404).

Support

For any question or bug report, write to support@datafirefly.com with your PrestaShop, PHP and module versions and the URL concerned.

Was this page helpful?

Still stuck? Contact support