dynamic / silverstripe-foxy
Foxy.io integration for SilverStripe websites.
Installs: 6 045
Dependents: 8
Suggesters: 0
Security: 0
Stars: 1
Watchers: 7
Forks: 3
Open Issues: 13
Type:silverstripe-vendormodule
Requires
Requires (Dev)
- pdepend/pdepend: ^2.5
- phploc/phploc: ^4.0
- phpmd/phpmd: ^2.6
- phpunit/phpunit: ^5.7
- sebastian/phpcpd: ^3.0
- squizlabs/php_codesniffer: ^3.0
- theseer/phpdox: ^0.11.0
README
Foxy.io integration for SilverStripe websites.
Requirements
- SilverStripe ^4.0
Installation
composer require dynamic/silverstripe-foxy
License
See License
Example configuration
Add the following extensions and configuration options to foxy.yml
:
PageController: extensions: - Dynamic\Foxy\Extension\PurchasableExtension Dynamic\Products\Page\Product: extensions: - Dynamic\Foxy\Extension\Purchasable Dynamic\Foxy\Model\FoxyHelper: cart_url: '' # from Foxy store settings secret: '' # from Foxy store advanced settings custom_ssl: 0 # (optional) enable custom ssl setting from Foxy store advanced settings max_quantity: 10 # maximum number of the same product that can be added to the cart product_classes: - Dynamic\Products\Page\Product include_product_subclasses: 1 # (optional) include subclasses of product_classes in queries
Create a DataExtension ProductOptionDataExtension
:
<? namespace { use Dynamic\Products\Page\Product; use SilverStripe\ORM\DataExtension; class ProductOptionDataExtension extends DataExtension { private static $belongs_many_many = [ 'Products' => Product::class, ]; } }
And add to foxy.yml
:
Dynamic\Foxy\Model\ProductOption: extensions: - ProductOptionDataExtension
Product Variation Configuration
Product variations are similar to the old Product Options, however they have been reworked to use the has many relation. This allows a more robust offering for product variations such as images per variation as well as inventory control (currently roadmapped).
You will need to implement a DataExtension for the new relation type to work:
VariationDataExtension.php
<?php namespace { use Dynamic\Products\Page\Product; use SilverStripe\ORM\DataExtension; /** * Class VariationDataExtension */ class VariationDataExtension extends DataExtension { /** * @var string[] */ private static $has_one = [ 'Product' => Product::class, ]; } }
Product option configuration
Product options can be set to trim whitespace off code modifications.
By default it will only trim spaces after the code and remove duplicate spaces.
Setting trimAllWhitespace
to true will trim all excess whitespace.
Dynamic\Foxy\Model\ProductOption: trimAllWhitespace: true
Templates
To include the AddToCartForm on your page/object, use <% include AddToCartForm %>
Maintainers
Bugtracker
Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.
If the issue does look like a new bug:
- Create a new issue
- Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
- Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.
Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.
Development and contribution
If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.