It's recommended to install the module from the repository when developing, please read the install from repository section.
When developing or testing the module it may be useful to connect it to your local Nosto environment or the the staging environment instead of the live one. This can be done by modying a "Dot Env" (.env) file in the Nosto SDK that the module uses. After having installed the module in PrestaShop, copy
PRESTASHOP/modules/nostotagging/libs/nosto/php-sdk/.env and modify the parameters.
NOSTO_SERVER_URL is the Nosto url used in the store front
NOSTO_API_BASE_URL is the base url for all API calls to Nosto
NOSTO_OAUTH_BASE_URL is the base url for connecting Nosto accounts through OAuth
NOSTO_WEB_HOOK_BASE_URL is the base url for Nosto web hooks
NOSTO_IFRAME_ORIGIN_REGEXP is a regexp for validating window.postMessage() event origin dispatched by the account configuration iframe (not in use in this module)
.env file can viewed here
Note that you can only have one .env file at a time, and if you wish to switch between environments you can copy them into
.env.[environment] files. This way you can switch the environment by replacing the .env with the correct .env.[environment] file.
In order to meet Prestashop's module validation rules, you must run the PHP Code Sniffer and no errors or warnings can be found. The repo has a custom rules defined in
ruleset.xml. You must define the
ruleset.xmlas the standard when running phpcs. In case you don't have phpcs installed, you can get it from here: https://github.com/squizlabs/PHP_CodeSniffer
Once installed go to the root directory and run
phpcs --standard=ruleset.xml -v .
Run "composer install --no-dev" to install dependencies excluding development required dependencies
When doing new releases of the module, you need to check the following:
The version number
Always change the version number when doing a new release
The version numbering follows the semantic versioning standard (http://semver.org/)
The version number is located in the main module file and the config.xml file, both in the modules root directory
Always create an entry in the CHANGELOG.md file for each new version
If the changes to the module require database changes, new custom hooks, structural or content, then an update script must be created
PrestaShop uses this script to do necessary changes when updating between versions
Place the script in
upgrade/upgrade-x.x.x.php where x.x.x corresponds to the new version number
In order to publish the new release to PrestaShop addons, you need to create a pull-request to the
PrestaShop/nostotagging repository, which this repository is a fork of. Always create the pull-request from Nosto:master => PrestaShop:master. PrestaShop will then review the release and publish it within a day or two. Remember to give a good explanation of the things that have changed in the pull-request comment field. It will help PrestaShop when reviewing.
Packaging the module is done with Phing. You will get Phing automatically when running composer without excluding the dev depencies. In other words, just run
composer install in the root directory. The only parameters you must give to phing command are the version of the plug-in and the path to global composer (where PHP Code sniffer can be found). Please note that you must have PHP Code Sniffer and PHP Mess Detector installed and available for Phing.
After phing is installed via composer, you must run
./libs/bin/phing -verbose -Dversion=X.Y.X -DcomposerDir=/path/to/composer
For example for version 2.7.1 the command would be
./libs/bin/phing -verbose -Dversion=2.7.1 -DcomposerDir=/home/nostodev/.composer
After successfully running the phing you will find a ready to install package from