- The Sorank module (recommended): you install a module in your back office and click one button. Your articles get a real SEO blog on your shop.
- A Webservice key: you create a key in your back office and paste it in Sorank. Articles are published as native CMS pages, with fewer SEO features.
With the module, setup takes about 5 minutes and you never copy a key: the module creates its own key with the minimum permissions Sorank needs.
Before you start
- Your shop runs PrestaShop 8 or PrestaShop 9.
- You can log in to your shop back office with an account that can install modules (for the module) or manage the Webservice (for a key).
- The address of your shop matches the website of your Sorank profile exactly: same scheme and same host.
https://www.example.comandhttps://example.comare two different addresses, so awwwmismatch is refused. - No other publishing platform is connected to this website in Sorank. Disconnect it first if needed.
Option A: connect with the Sorank module (recommended)
The connection window in Sorank guides you through three steps: download the module, install it, connect it.Step 1: Download the module
In Sorank, open Settings, then Publishing platforms. Click Connect your website on the PrestaShop card. You can also pick PrestaShop when Sorank asks you to connect your website during onboarding.
sorank.zip file.

- Download the module prepares a module made for this website.
- The connection link of the module works once, for 7 days. If it expires or was already used, download the module again.
- Connect with a Webservice key instead opens option B.
Step 2: Install the module in PrestaShop
Open your shop back office in another tab.- Open Modules, then Module Manager.
- Click Upload a module.

- Drop the sorank.zip file in the window, or click select file and choose it.

- When PrestaShop shows Module installed!, click Configure.

Step 3: Connect your shop to Sorank
On the module page, click Connect to Sorank.


- The connection mode: Module.
- The version of the module installed on your shop.
What the module adds to your shop
The module turns the Blog CMS category into an SEO blog rendered with your shop theme:- Blog URLs: each article lives at
/blog/{slug}. On a multilingual shop, the language is added by PrestaShop, for example/fr/blog/{slug}. The listing at/blogshows your articles with their cover, excerpt and date, 12 per page. If another module of your shop, such as a blog module, already uses/blog, the Sorank blog moves to a translated address instead, for example/articles/{slug}, and leaves the pages of that module untouched. You can choose the address of each language in the Blog address section of the module page. - Redirects: the native CMS address of a blog article answers with a permanent redirect (301) to its blog URL. When you change the slug of a published article, the previous URL redirects to the new one.
- SEO tags: canonical URL, meta title and description,
hreflangfor the languages the article is really published in, Open Graph and Twitter tags. - Structured data:
BlogPostingandBreadcrumbListin JSON-LD. - Sitemap: the blog listing and articles are added to the sitemap generated by the PrestaShop gsitemap module.
- Article fields: cover image, excerpt, author, publication date and the
noindexsetting. - IndexNow: from version 1.1.0, the module serves your IndexNow key file, so Sorank can notify Bing and other search engines of each new article. Once the module serves the key, Sorank also submits, once, the articles it already published on your shop. See publish and export.

Option B: connect with a Webservice key
Use this method if you cannot install a module. In the PrestaShop connection window, click Connect with a Webservice key instead. Sorank lists the steps and the permissions to tick.
Step 1: Create the key in PrestaShop
- In your back office, open Advanced Parameters, then Webservice.
- Set Enable PrestaShop’s webservice to Yes, then save.
- Click Add new webservice key.

- Enable PrestaShop’s webservice, in the Configuration section.
- Add new webservice key.
- Click Generate to create the key.

- Tick these permissions:

content_management_system: publish, update and unpublish your articles.languages: find the languages of your shop.products: import your products into your product catalog.
- Save the key, then copy it. Keep it private: anyone with this key can edit your CMS pages.
Step 2: Paste the key in Sorank
In Sorank, click Continue, then fill in:- Shop address: the address of your shop, as visitors see it. Sorank fills it in with the website of your profile.
- Webservice key: the 32 characters you copied.
- CMS category ID (optional): the CMS category where articles are published. Leave it empty to publish in the main CMS category.

- The permissions the key is missing. Tick them on the key in PrestaShop, save, then click Connect again.
- The address of your shop.
- Your Webservice key, hidden as you type it.
Limits without the module
- Articles are native CMS pages, served at their native PrestaShop address. There is no blog listing and no blog URL.
- There is no separate cover image: Sorank inserts it as the first image of the content. The excerpt, author, publication date, structured data and the
noindexsetting are not available. - The slug of a published article cannot change.
- Sorank does not import images into your shop.
- Sorank publishes into one CMS category: the one you entered, or the main category.
- Sorank cannot notify Bing and other search engines through IndexNow.
Publish and manage your articles
Once connected, PrestaShop works like the other publishing platforms. Open an article in Content > Articles:- Publish an article now: click Publish, then Confirm. With the module, Sorank publishes in the Blog category. You can also schedule it in your content calendar.
- Update a published article: edit it in Sorank, then click Update live article. Sorank updates the page on your shop.
- Unpublish an article: the page is hidden on your shop. You can publish it again later.

- Sorank publishes the article in the Blog category of your shop. Turn on Publish as draft to create the page on your shop without taking it live, then click Confirm.

- View published article opens the article on your shop.
- Update live article sends your latest changes to your shop.
- Unpublish takes the article offline.

Deleting an article in Sorank keeps its page published on your shop. To remove an article from your shop, unpublish it first, then delete it in Sorank.
Troubleshooting
When a connection fails, the Sorank window shows The connection did not go through with the reason. The PrestaShop Webservice is off. Enable it in Advanced Parameters > Webservice, then try again. With the module, click Connect to Sorank again. Your hosting blocks the key before it reaches PrestaShop. Some hosts remove theAuthorization header that carries the key. The Diagnostics box of the module page shows it too. Add this line to the .htaccess file at the root of your shop:
Authorization header to PHP.
PrestaShop refused the key. The key was deleted, disabled or regenerated in your back office, or was not copied entirely. Reconnect your shop: click Connect to Sorank again in the module, or paste a new Webservice key.
The key is missing permissions. Sorank lists the missing resources. Tick them on the key in PrestaShop, save the key, then try again. With the module, click Connect to Sorank again.
Friendly URLs are off. Sorank still connects, but articles get long addresses such as index.php?fc=module&module=sorank&controller=post&slug=.... Enable friendly URLs in Shop Parameters > Traffic & SEO.
The module is too old. Sorank asks you to update it. Download the module again from the PrestaShop connection window and install it over the current one.
The connection link has expired or was already used. Download the module again, then install it over the current one.
The address does not match. The shop address must be exactly the website of your Sorank profile, including www when your website uses it.
Sorank could not reach your shop. Check that your shop is online and reachable from the internet, then try again.
Another publishing destination is already connected to this site. Disconnect it on its card in Sorank, then connect PrestaShop.
Only the owner of this site can download the module. Ask the owner of the Sorank account to download the module, or to connect the shop.
Your articles do not appear in your existing blog. The Sorank module publishes your articles in its own blog, not in the categories of another blog module. When that module already uses /blog, Sorank shows Another module of your shop already uses the /blog address and publishes your articles under a translated address such as /articles. Open the module page in your back office: the Blog address section shows the address in use for each language and lets you choose another one. Then add a link to this address in your shop menu so that your visitors find your articles. If the module page has no Blog address section, update the module first.
Update the module
When a newer module is available, the PrestaShop card shows Download the new module. Download it, then in your back office open Modules > Module Manager, click Upload a module and drop the new sorank.zip file: PrestaShop installs it over the current one. Then click Configure and Connect to Sorank: the module reuses its Webservice key, and your articles stay on your shop.Disconnect or uninstall
To stop publishing, click Disconnect on the PrestaShop card in Sorank. If you uninstall the Sorank module in PrestaShop, the module deletes its Webservice key, gives the pages their native indexing back, and marks the connection as disconnected in Sorank. Your articles stay on your shop as native CMS pages, at their native address, and keep their images. The module notifies Sorank when it can reach it: to be sure, also click Disconnect on the PrestaShop card. If you disable the Sorank module without uninstalling it, the/blog pages go offline and your articles can be indexed again at their native CMS address. Enable the module again to bring the blog back.
