Troubleshooting

Display issues

Icons are not displaying

PrestaBlog uses Material Icons, PrestaShop's default icon font, to ensure maximum compatibility with most marketplace themes.

Possible causes:

• Your theme has replaced Material Icons with another icon font
• The theme developer removed access to this native PrestaShop feature
• A CSS conflict prevents icons from displaying

Solution:

Go to configuration > global > at the bottom, on the left side of the configuration, find "Add Material Icons in header" and enable it, then update. Don't forget to refresh your shop cache in advanced settings > performance and your browser if you don't see any changes.

My published article doesn't appear

You have published an article but it is not visible on your blog's front-office.

Checks to perform:

• Category visibility: verify that the article's category is visible to visitors or the relevant customer group. Go to Content Management > Categories to check visibility settings.
• Article status: make sure the article is set to "Published" status and not draft
• Publication date: if you have scheduled a future publication, the article will only be visible from that date
• PrestaShop cache: clear your store cache in Advanced Parameters > Performance

Images are not displaying correctly

Images from your articles or categories are not displaying or appear distorted.

Solutions:

• Check dimensions: make sure uploaded images respect the dimensions configured in Configuration > Images
• Regenerate images: use the image regeneration tool after modifying dimensions in configuration
• Write permissions: verify that the modules/prestablog/images/ folder has appropriate write permissions (chmod 755 or 775)

Common errors

404 error on blog homepage

404 errors on the blog homepage are usually caused by a conflict with an old blog module or a module that modifies your store's URLs.

Check the following situations:

• Old blog module: a blog module was improperly uninstalled or is still installed on your store
• .htaccess file: a "blog" entry is present in the .htaccess file at the root of your FTP
• Blog folder: a "blog" folder exists at the root of your PrestaShop installation
• URL rewriting module: a third-party module modifies your URLs in a way incompatible with PrestaBlog

404 error on blog pages

404 errors on internal blog pages (articles, categories) usually come from a conflict with a third-party module that interferes with PrestaShop's URL controllers.

Solutions:

• Identify the responsible module by temporarily disabling URL rewriting modules
• Contact the module developer to request an exception or compatibility update
• Verify that PrestaBlog URLs don't conflict with other pages in your store

Error during installation or update

If you encounter an error during module installation or update, your server is probably not configured correctly for file processing.

Check your server configuration:

In your back-office, go to Advanced Parameters > Information > Server information and check the following values:

• Memory limit (memory_limit): 256M minimum recommended
• Maximum execution time (max_execution_time): 30 seconds minimum
• Maximum upload file size (upload_max_filesize): 20M minimum
• Maximum POST data size (post_max_size): 20M minimum

To modify these values:

Edit your php.ini file with the following values:

memory_limit = 256M
                    upload_max_filesize = 20M
                    post_max_size = 20M
                    max_execution_time = 30

Unable to update the module

If you cannot download the latest version of the module, check your update eligibility.

How updates work on Addons:

When purchasing a module on PrestaShop Addons, you receive free support and updates for 3 months. After this period, you must subscribe to the Zen Option to continue receiving updates.

Zen Option includes:

• Unlimited after-sales support for 1 year
• Access to all minor and major module updates

Zen Option does not include:

• Customization and specific development
• Installation and update services
• Resolution of issues related to third-party services, hosting or server

To subscribe to Zen Option, go to the Support and updates tab in your PrestaShop Addons customer account, select PrestaBlog and add the option to your cart.

Performance

If your blog takes time to load, several optimizations are possible.

Recommended optimizations:

• Enable PrestaShop cache: in Advanced Parameters > Performance, enable cache and template compilation
• Optimize your images: use properly sized and compressed images before uploading
• Limit articles per page: in PrestaBlog configuration, reduce the number of articles displayed per page if necessary
• Check your hosting: low-end shared hosting can impact performance

Multishop Configuration

In multishop mode, PrestaBlog works with one blog per store. Here are the important points to remember for correct configuration.

Operating principles:

• Each store has its own blog with its own articles and categories
• Before any configuration, select the relevant store in the selector at the top right of the back-office
• Configurations are independent for each store

Correct configuration example:

• FR Store: www.mystore.fr/blog
• EN Store: www.mystore.com/blog
• ES Store: www.mystore.es/blog

Incorrect configuration example:

• FR Store: www.mystore.fr/blog
• EN Store: www.mystore.com/news (404 error)

Contact support

If you have suggestions regarding PrestaBlog, feel free to send us feedback via the support contact form!

If you haven't found the solution to your problem in this documentation, our support team is available to help you.

Fast & responsive support

Our team typically responds within 15 minutes during business hours.

How to contact us:

• Via PrestaShop Addons: log in to your Addons account and go to the contact page for PrestaBlog
• Useful information to provide: PrestaShop version, PrestaBlog version, detailed problem description, screenshots if possible