Download the PHP package pankrok/shoper-appstore-bundle without Composer
On this page you can find all versions of the php package pankrok/shoper-appstore-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package shoper-appstore-bundle
Shoper Appstore Symfony Bundle
Unofficial Symfony 7.4 bundle for building applications on the Shoper Appstore. Provides OAuth integration, REST API client, billing and webhook handling, Twig helpers, and Maker commands for scaffolding controllers. Not official Shoper software.
Current version: 2.2.0
Table of contents
- Technologies
- Setup
- Configuration
- Token refresh CRON
- Error handling
- Documentation
Technologies
- PHP 8.2
- Symfony 7.4 LTS
- Doctrine ORM
- Twig
- Symfony HttpClient
- Symfony MakerBundle
Setup
Install via Composer:
Create the database tables:
Configuration
OAuth mode (Appstore)
Create config/packages/appstore.yaml:
Basic Auth mode (admin username/password)
Rate limiting (optional)
Token refresh CRON
Run the token refresh command every 4 hours to keep OAuth tokens valid:
Available options:
| Option | Default | Description |
|---|---|---|
--limit |
200 |
Maximum number of tokens to refresh per run |
--hours-ahead |
23 |
Refresh tokens expiring within this many hours (max 23) |
Example crontab entry (every 4 hours):
Note: The old command name
ShoperAppstoreBundle:TokenRefreshis kept as a BC alias.
Error handling
All Shoper API errors throw ShoperApiException, which extends Symfony's HttpException and carries the original error code and description from the API response.
The bundle ships an ExceptionSubscriber that automatically intercepts ShoperApiException and renders a clean Aurora-compatible error page instead of the Symfony debug page — no configuration needed.
To override the error template in your application, create:
Catching the exception manually in a controller:
Tests
The suite is pure unit tests (no kernel, database or network — HTTP goes through MockHttpClient):
Documentation
| Topic | File |
|---|---|
| ApiController reference | docs/APICONTROLLER.md |
| OAuth & Basic Auth | docs/AUTH.md |
| Aurora forms | docs/AURORAFORMS.md |
| Billing system | docs/BILLING.md |
| Events | docs/EVENTS.md |
| Iframe / JS SDK | docs/IFRAME.md |
| API Resources | docs/RESOURCES.md |
| Shoper Controller | docs/SHOPERCONTROLLER.md |
| Twig filters | docs/TWIGFILTERS.md |
| Webhooks | docs/WEBHOOK.md |
All versions of shoper-appstore-bundle with dependencies
doctrine/dbal Version ^3.8|^4
doctrine/doctrine-bundle Version ^2.13
doctrine/doctrine-migrations-bundle Version ^3.3
doctrine/orm Version ^3.2
symfony/console Version 7.4.*
symfony/framework-bundle Version 7.4.*
symfony/http-client Version 7.4.*
symfony/monolog-bundle Version ^3.7|^4.0
symfony/twig-bundle Version 7.4.*
symfony/yaml Version 7.4.*
twig/extra-bundle Version ^3.12
twig/twig Version ^3.12