> For the complete documentation index, see [llms.txt](https://optimize.pencidesign.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://optimize.pencidesign.net/1.-installation-1.md).

# 1. Installation

**Requirements**

* Active PHP Extension `mbstring` on the Hosting
* Allow using PHP function `curl_exec`

#### Installation

You install normally like other plugins but use the file upload method. *Note*: In order for the installation to be successful, you need to make the folder wp-content/plugins writable.

Before proceeding to install the plugin we suggest you to disable cache plugins such as WP Rocket, W3 Total Cache..to avoid errors during optimization implementation. After optimization is complete, re-enable the cache plugin and configure it according to the instructions in step 4.

To install, you login to the WP admin page and go to  **Appearance > Install Plugins > select to install plugin "Penci Shortcodes & Performan" and "Penci Speed Optimizer"**. You need to activate both plugins **"Penci Shortcodes & Performan" and "Penci Speed Optimizer"** to get it works correctly. 

After installed & activated the plugins **"Penci Shortcodes & Performan" and "Penci Speed Optimizer"**, you can go to Customize > Speed Optimization > PageSpeed Optimizer > and check to "Enable Page Speed Optimizer"

**Note**: 

* Set PHP memory limit in the wp-config.php file: `define('WP_MEMORY_LIMIT', '512M');`

#### Usage

This plugin will not edit or delete any files on the hosting. The optimization process will generate new js & CSS files based on the original files of the website. In case you change CSS and js files for your theme and plugins so you need to tell with the plugin that you have modified them. To do this you can go to **Dashboard > Settings > PageSpeed Optimizer** > and press the **\[Purge All]** button to refresh the CSS and js files generated for optimization.

#### Hosting configuration

Some hosting have to install software for viruses scanning or **security plugins** automatically delete suspicious files. **Penci Speed Optimizer** plugin has used `curl_exec` function, and the PHP file can be removed by your host. To ensure plugin works without errors, please exclude virus scan from folder `plugins/wp2speed`

Enable `mbstring` php extension.In cpanel, find 'Select PHP Version' & click on it.![](https://www.evernote.com/shard/s382/res/b50fd006-27dd-4419-8217-879115d4cbbb.png?resizeSmall\&width=1344)

![](/files/-MYNvlqoukeVtgL9gFLL)

 \
Check `mbstring` as bellow:![](https://www.evernote.com/shard/s382/res/de5075ef-326d-41f6-b747-b2c20e2e01a3.png?resizeSmall\&width=1344)

![](/files/-MYQLmkRDy4iNQOCcV-p)

Allow `curl_exec` function.in \`Select PHP Version\` app, click on 'Options' tab.![](https://www.evernote.com/shard/s382/res/644df258-4a2a-4dde-8d73-c43a12d879ef.png?resizeSmall\&width=1344)

![](/files/-MYNvlqjwrhS0p9J4rbg)

And make sure \`curl\_exec\` not in disable\_functions field.![](https://www.evernote.com/shard/s382/res/1147d98b-4571-46d3-970b-0488b75ae6c4.png?resizeSmall\&width=1344)

![](/files/-MYNvlqn7IDouWf3r5-3)

\
Exclude virus scan in the plugin folder. Open `imunify 360 / imunify AV` app in cpanel. Click tab 'Ignore list' & click the link 'Add new file or directory'.![](https://www.evernote.com/shard/s382/res/7c1a22f4-d471-4d46-b316-ba037638b02c.png?resizeSmall\&width=1344)

![](/files/-MYNvlqqNxNn9U07fSKv)

Enter the absolute path to **Penci Speed Optimizer** plugin & click ADD button, like this:

`$HOME/wp-content/plugins/wp2speed`

### Disable opcache when you got 503 error after activate plugin "Penci PageSpeed Optimizer"

In some case, if you using PHP 8, you can get an error 503 issue after activating the plugin Penci PageSpeed Optimizer - you just need to go to your hosting > Cpanel > Select PHP Version > click on the "Extensions" tab and disable the  **opcache**  extension - check the image below:

![](/files/-M_8vlfVk5xaxOCjotWr)