website·Indexed 31 days ago
https://prestaflow.io/docsAutomated end-to-end testing for e-commerce modules, specifically designed for PrestaShop. The platform provides a PHP library for creating test suites with features including visual regression checkpoints, PDF assertions, and theme-aware selectors. It supports PrestaShop versions 1.7, 8, and 9, and offers CI/CD integrations for GitHub Actions, GitLab, Bitbucket, and CircleCI.
PrestaFlow provides a hosted E2E testing infrastructure for PrestaShop modules. It automates the provisioning of PrestaShop environments, installation of modules, and execution of test suites. Key features include:
Pages/v7, Pages/v8, Pages/v9) and runtime auto-detection. This allows developers to write version-agnostic scenarios (e.g., "open the product page") that the library translates into the correct selectors for the detected version.PrestaFlow\Library\Support\Pdf class (available since v1.6.0) is a wrapper around smalot/pdfparser used to assert text content in documents like invoices, credit notes, and delivery slips. The parser is instantiated lazily on the first read and results are cached per instance to allow chaining of methods without re-parsing.composer run prestaflow:json:file, optionally provisions a PrestaShop Flashlight instance, uploads results to the PrestaFlow API, publishes raw reports and screenshots as GitHub artifacts, and posts a summary comment on pull requests.actions/cache. It provides a side-by-side diff (Reference, Actual, and Diff) accessible via a public link for team review, with the ability to refresh the baseline on demand using a salt.log and console methods are aliases and can be used interchangeably to print strings or arrays of data for debugging purposes.it('check product price', function () use ($frontOfficeProductPage) {
$frontOfficeProductPage->goToProduct(42);
$price = $frontOfficeProductPage->getPrice();
// Log a simple string
$this->log('price: ' . $price);
// Log an array of data
$this->console(['raw' => $price, 'formatted' => '$' . $price]);
Expect::that($price)->isGreaterThan(0);
});ps_onepagecheckout module in PrestaShop 9.2. It provides support for the FrontOffice page, BackOffice settings pages, and two ready-to-use scenarios: OnePageCheckoutOrder and OnePageCheckoutGuest. These scenarios automatically skip with an explicit message on versions below 9.2. Note that the one-page layout is only compatible with the Hummingbird theme.$this->describe('Place an order through the One Page Checkout')
->scenario(\PrestaFlow\Library\Scenarios\OnePageCheckoutOrder::class);suites input. Nested paths (e.g., FrontOffice/Checkout) are supported. This requires prestaflow/php-library version ^1.8.0; earlier versions will ignore the filter and run all suites. If a specified suite name does not match any folder, the run will fail.- name: Run selected suites
uses: PrestaFlow/github-action@v2
with:
token: ${{ secrets.PRESTAFLOW_TOKEN }}
projectId: '42'
suites: BackOffice,FrontOfficesrc/Tests/Scenarios that extends PrestaFlow\Library\Scenarios\Scenario. Implement the steps($testSuite) method to define the logic and return the $testSuite object. You can then reference this scenario in a Test Suite using the scenario() method.// src/Tests/Scenarios/DoNothing.php
namespace Shop\Tests\Scenarios;
use PrestaFlow\Library\Scenarios\Scenario;
class DoNothing extends Scenario
{
public function steps($testSuite)
{
$testSuite
->todo('will do nothing (again)', function () {
})
;
return $testSuite;
}
}
// In your Test Suite (e.g., Tests/First.php)
namespace Tests;
use PrestaFlow\Library\Tests\TestsSuite;
use Shop\Tests\Scenarios\DoNothing;
class First extends TestsSuite
{
public function init()
{
$this
->describe('PrestaFlow: my first scenario')
->scenario(DoNothing::class)
;
}
}