Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Immersion in the Sylius

Immersion in the Sylius

Slides from my first talk ever, presented at Symfony CAMP UA 2013.

Pawel Jedrzejewski

October 26, 2013

More Decks by Pawel Jedrzejewski

Other Decks in Programming


  1. Who am I? Paweł Jędrzejewski Huge beliver in Open Source

    Symfony & BDD evangelist Creator of Sylius Working for Opensoft on
  2. ?

  3. THE PROBLEM PHP has changed This change created the market

    for a new e-commerce solution among developers With the flexibility of modern frameworks and the new way of collaboration we can build something interesting for the business Sylius reflects this evolution
  4. WHAT IS SYLIUS A short history Open sourced in 2011

    as a set of bundles Main application in development for ~9 months Already used in production by developers and companies
  5. QUALITY Behat and phpspec, perfect combination Most of new features

    start with an RFC issue Discussion about the idea and eventual implementation Behat features Implementation
  6. BUNDLES vs. MAIN APPLICATION Set of 19 decoupled and independent

    bundles Can be used to create a custom platform Integrate e-commerce into existing application Standard webshop experience Highly customizable Easy to understand for every Symfony2 developer
  7. Sylius Bundles What they can do for you? EVERY SINGLE

  8. Simpler CRUD for symfony SyliusResourceBundle Removing tons of duplicated code

    in controllers for basic CRUD actions. Removing the manager and manipulator classes, relying on Doctrine instead. Removing the "frontend" and "backend" controllers. Supporting different persistence layers. Make the controllers format agnostic. (API)
  9. ADD YOUR RESOURCE sylius_resource: resources: acme.user: driver: doctrine/orm templates: AcmeShopBundle:User

    classes: model: Acme\ShopBundle\Entity\User repository: Acme\ShopBundle\Entity\UserRepository controller: Acme\ShopBundle\Controller\UserController
  10. acme_user_show: pattern: /users/{id} methods: [GET] defaults: _controller: acme.controller.user:showAction acme_profile_show: pattern:

    /profile/{username} methods: [GET] defaults: _controller: acme.controller.user:showAction _sylius: template: AcmeShopBundle:Profile:show.html.twig criteria: { username: $username, enabled: true }
  11. acme_profile_show: pattern: /profile/{username} methods: [GET] defaults: _controller: acme.controller.user:showAction _sylius: template:

    AcmeShopBundle:Profile:show.html.twig method: findOneForProfilePage arguments: [$username] acme_user_disabled_index: pattern: /users/disabled methods: [GET] defaults: _controller: acme.controller.user:indexAction _sylius: template: AcmeShopBundle:User:disabled.html.twig criteria: { enabled: false }
  12. acme_user_recently_registered: pattern: /users/recently-registered methods: [GET] defaults: _controller: acme.controller.user:indexAction _sylius: template:

    AcmeShopBundle:User:recentlyRegistered.html.twig criteria: { enabled: true } sorting: { createdAt: desc } paginate: false limit: 5
  13. acme_user_update_addresses: pattern: /users/{id}/update-addresses methods: [GET] defaults: _controller: acme.controller.user:updateAction _sylius: template:

    AcmeShopBundle:User:updateAddresses.html.twig form: acme_user_addresses redirect: route: acme_user_index
  14. CONFIGURATION sylius_taxation: driver: doctrine/orm classes: tax_rate: model: Acme\ShopBundle\Entity\TaxRate controller: Acme\ShopBundle\Controller\TaxRateController

    repository: Acme\ShopBundle\Entity\TaxRateRepository form: Acme\ShopBundle\Form\Type\TaxRateType validation_groups: tax_rate: [sylius, acme]
  15. USING CUSTOM MODELS and FORMS Every model class can be

    overridden All repositories, managers and forms are updated automatically Form class can be customized
  16. YOUR OWN REPOSITORY Sylius repositories extend native Doctrine implementations Override

    the repositories through configuration Repositories are services
  17. CHANGE THE RULES, VALIDATION All Sylius models ship with their

    own validation mapping under group „sylius” You can easily override it with your own rules Consistent translation messages
  18. DOCTRINE RTEL, DYNAMIC RELATIONS We're using interfaces instead of implementation

    to define the relations When you override the model class, all relations get updated automatically Defaults are turned into entities if you don't provide your own class
  19. WE LOVE EVENTS, YOU SHOULD TOO The default controller triggers

    multiple useful events during CRUD actions sylius.product.pre_create sylius.product.post_create
  20. ORDERS AND CART SyliusOrderBundle + SyliusCartBundle Generic Order model with

    support of Adjustments Cart bundle provides actions and services for customer to interact with the Order entity The order/cart items can be easily customized to handle different options
  21. COUNTRIES, ZONES AND ADDRESSES SyliusAddressingBundle Provides a very basic Address

    model Countries and their Provinces management Zones system with a ZoneMatcher service Useful for taxation and shipping zones
  22. TAKE CARE OF YOUR INVENTORY SyliusInventoryBundle Built around 1 interface

    you need to implement Tracks every single inventory unit Based on events Items available on demand Backorders
  23. HATE IT OR LOVE IT, TAXATION SyliusTaxationBundle TaxableInterface = heart

    of the bundle Multiple tax categories and rates support Customizable tax calculators Tax included in price
  24. MERCHANDISE NEEDS TO BE SHIPPED SyliusShippingBundle Integrate through one interface

    Manage Shipments and Shipping Methods Custom shipping rules Flexible calculators system
  25. class PerItemRateCalculator extends Calculator { public function calculate(ShippingSubjectInterface $subject, array

    $configuration) { return $configuration['amount'] * $subject->getShippingItemCount(); } public function getConfigurationFormType() { return 'sylius_shipping_calculator_per_item_rate_configuration'; } public function setConfiguration(OptionsResolverInterface $resolver) { $resolver ->setRequired(array( 'amount')) ->setAllowedTypes(array('amount' => array('numeric'))) ; } }
  26. CATEGORIZE ALL THIS STUFF, NOW SyliusTaxonomiesBundle Classify any Model using

    different Taxonomies Flexible forms Based on DoctrineExtensions
  27. JUST FEW STEPS MORE SyliusFlowBundle Useful for anything which takes

    more than 1 action to complete Checkouts, installation wizards, complex actions Used by OroCRM and Akeneo PIM for installers
  28. PROCESS SCENARIO <?php class CheckoutProcessScenario implements ProcessScenarioInterface { public function

    build(ProcessBuilderInterface $builder) { $builder ->add('security', 'sylius_checkout_security') ->add('addressing', 'sylius_checkout_addressing') ->add('shipping', 'sylius_checkout_shipping') ->add('payment', 'sylius_checkout_payment') ->add('finalize', 'sylius_checkout_finalize') ->add('purchase', 'sylius_checkout_purchase') ; } }
  29. PAYUM INTEGRATION SyliusPayumBundle NEW! Integrates Payum library into Sylius checkout

    Replaceable by other bundles in future PayPal Express Checkout and Stripe support Omnipay usage through a bridge
  30. Make your app configurable, EASILY SyliusSettingsBundle You can define settings

    schema and the form User edits the settings through UI You get the access via services and Twig
  31. Settings schema class GeneralSettingsSchema implements SchemaInterface { public function buildSettings(SettingsBuilderInterface

    $builder) { $builder ->setDefaults(array( 'meta_keywords' => 'symfony, sylius, ecommerce, webshop, shopping cart', 'meta_description' => 'Sylius is modern ecommerce solution for PHP.', )) ->setAllowedTypes(array( 'meta_keywords' => array('string'), 'meta_description' => array('string'), )) ; }
  32. EDITING VIA FORM public function buildForm(FormBuilderInterface $builder) { $builder ->add('meta_keywords',

    'text', array( 'constraints' => array(new NotBlank()) )) ->add('meta_description', 'textarea', array( 'constraints' => array(new NotBlank()) )) ; }
  33. PROMOTIONS ARE NICE SyliusPromotionsBundle Can be integrated with any Model

    Very flexible Actions and Rules system Support for promotion coupons
  34. CUSTOM RULES interface RuleCheckerInterface { /** * @param PromotionSubjectInterface $subject

    * @param array $configuration * * @return Boolean */ public function isEligible(PromotionSubjectInterface $subject, array $configuration); /** * @return string */ public function getConfigurationFormType(); }
  35. YOUR OWN ACTIONS class AddPackageAction implements PromotionActionInterface { public function

    execute(PromotionSubjectInterface $subject, array $configuration) { $package = $this->findPackage($configuration); $item = $this->cartItemRepository->createNew(); $item->setQuantity(1); $item->setUnitPrice(isset($configuration['price']) ? $configuration['price'] : $package->getGrossPrice()); $item->setPackage($package); $subject->addItem($item); } public function getConfigurationFormType() { return 'xyz_promotion_action_add_package_configuration'; } }
  36. INSTALLATION $ composer create-project sylius/sylius -s dev path/to/install $ cd

    path/to/install $ app/console sylius:install $ composer create-project sylius/sylius-standard -s dev path/to/install $ cd path/to/install $ app/console sylius:install
  37. ONE CORE TO RULE THEM ALL SyliusCoreBundle Integrates all the

    bundles together Standard webshop application Contains all the models and services
  38. THE WEB INTERFACE SyliusWebBundle Provides the default web interface for

    Sylius Contains all the templates and menu builders Splitted into Frontend & Backend parts
  39. public function forwardAction(ProcessContextInterface $context) { $request = $this->getRequest(); $order =

    $this->getCurrentCart(); $this->dispatchCheckoutEvent(SyliusCheckoutEvents::ADDRESSING_INITIALIZE, $order); $form = $this->createCheckoutAddressingForm($order); if ($request->isMethod('POST') && $form->bind($request)->isValid()) { $this->dispatchCheckoutEvent(SyliusCheckoutEvents::ADDRESSING_PRE_COMPLETE, $order); $this->getManager()->persist($order); $this->getManager()->flush(); $this->dispatchCheckoutEvent(SyliusCheckoutEvents::ADDRESSING_COMPLETE, $order); return $this->complete(); } return $this->renderStep($context, $order, $form); }
  40. TO DO Documentation, documentation, documentation New default store look Rework

    translations and integrate with CrowdIn Polish the checkout process Integrate BazingaHateoasBundle for API Integrate Symfony CMF and Create.js
  41. COMING SOON... Pull Requests Customer groups Subscriptions support Product reviews

    Symfony CMF integration (editable blocks and pages) Facebook/Amazon and so on...