Developing & Contributing
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.example to 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)
The sample .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.

Running PHP Code Sniffer

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
1
phpcs --standard=ruleset.xml -v .
Copied!

Development on Prestashop 1.7

Run "composer install --no-dev" to install dependencies excluding development required dependencies

Releasing and Packaging

When doing new releases of the module, you need to check the following:
    1.
    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
    2.
    Update scripts
      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

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
1
./libs/bin/phing -verbose -Dversion=X.Y.X -DcomposerDir=/path/to/composer
Copied!
For example for version 2.7.1 the command would be
1
./libs/bin/phing -verbose -Dversion=2.7.1 -DcomposerDir=/home/nostodev/.composer
Copied!
After successfully running the phing you will find a ready to install package from $root_dir/build/package
Last modified 1yr ago