Presentation on the development state of Drupal Commerce 2.x. http://dwkitchen.github.io/commerce-2.x-slides

1. DRUPAL COMMERCE 2.X
DRUPAL CAMP LONDON 2015
Presented by David Kitchen / @dwkitchen

2. INTRODUCTIONS

3. DAVID KITCHEN

4. Technical Lead for Commerce Guys UK
Tax specialist and Commerce Contributor

5. DRUPAL COMMERCE 2.X CO-MAINTAINERS

6. Bojan Zivanovic (bojanz)
and Ryan Szrama (rszrama)

7. Our vision is for Drupal Commerce to be the number one
open source e-commerce platform in the world...
Powering truly flexible e-commerce.

8. DRUPAL COMMERCE 1.X
A brief history.

9. BUILT FROM SCRATCH ON DRUPAL 7

10. MINIMALISTIC AND FLEXIBLE

11. USES VIEWS FOR ALL LISTINGS

12. USES RULES FOR BUSINESS LOGIC

13. RELIES ON "ESSENTIAL CONTRIBS" AND DISTRIBUTIONS TO
COMPLETE THE EXPERIENCE

14. WE'RE DOING SOMETHING RIGHT...

15. SYMFONY PHP LIBRARIES

16. WE* STARTED WITH RESEARCH
*Led by Bojan Zivanovic.
Define the deficiencies in our own software
Existing */money libraries
Sonata / Sylius e-commerce bundles
Non-Symfony PHP applications
Non-PHP applications

17. IDENTIFYING OUR WEAKNESSES
Age old tax management issues
Incomplete price management API
Incomplete currency formatting rules
Address implementation stretched to the limit
Limited ability to collaborate outside of Drupal

18. PROPOSING STANDALONE SOLUTIONS
Internationalization (esp. currency formatting)
Address formatting / validation
Territory grouping (to support taxing)
Tax rate management (at least for VAT)
Price calculation and manipulation

19. Not just interfaces / classes but unprecedented data.also

20. Minimal dependencies.

21. Simple APIs with clear documentation and examples.

22. Full test coverage.

23. Reusable by any PHP based e-commerce application.

24. INTL
Number Formatter, inspired by intl.
Currencies
Countries
Languages
COMING SOON
Date Formatting
Drupal Commerce blog.

25. CURRENCY HANDLING
$ ¢ £ p ¥ ₤ ₧ € ₹ ₩ ₴ ₯ ₮ ₲ ₳ ₵ ₭ ₪ ₫

26. CURRENCY FORMATTING
€12,345.99
12 345,99 €
12.345,99 €
۹۹۹٫۹۹ .‫ﺩ.ﺇ‬

27. PRICING
A price is a value object. Each operation (add, subtract,
multiply, divide, round) produces a new price instance. All
amounts are passed as strings, and manipulated using
bcmath.

28. CREATING PRICES
use CommerceGuysIntlCurrencyCurrencyRepository;
use CommerceGuysPricingPrice;
$currencyRepository = new CurrencyRepository;
$currency = $currencyRepository­>get('EUR');
$firstPrice = new Price('99.99', $currency);
$secondPrice = new Price('100', $currency);
$thirdPrice = new Price('20.307', $currency);

29. PRICE OPERATIONS
// Every operation produces a new Price instance.
$total = $firstPrice
­>add($secondPrice)
­>subtract($thirdPrice)
­>multiply('4')
­>divide('2');
echo $total; // 359.366 EUR
echo $total­>round(); // 359.37 EUR
echo $total­>round(Price::ROUND_HALF_UP, 1); // 359.4 EUR
echo $total­>greaterThan($firstPrice); // true

30. CURRENCY CONVERSION
use CommerceGuysIntlCurrencyCurrencyRepository;
use CommerceGuysPricingPrice;
$currencyRepository = new CurrencyRepository;
$eur = $currencyRepository­>get('EUR');
$usd = $currencyRepository­>get('USD');
// Use an external library to get an actual exchange rate.
$rate = 1;
$eurPrice = new Price('100', $eur);
$usdPrice = $eurPrice­>convert($usd, $rate);
echo $usdPrice;

31. CURRENCY FORMATTING
use CommerceGuysIntlCurrencyCurrencyRepository;
use CommerceGuysIntlNumberFormatNumberFormatRepository;
use CommerceGuysIntlFormatterNumberFormatter;
use CommerceGuysPricingPrice;
$currencyRepository = new CurrencyRepository;
$currency = $currencyRepository­>get('USD');
$price = new Price('99.99', $currency);
$numberFormatRepository = new NumberFormatRepository;
$numberFormat = $numberFormatRepository­>get('en­US');
$currencyFormatter = new NumberFormatter($numberFormat, NumberFormatter::CURRENCY
echo $currencyFormatter­>formatCurrency($price­>getAmount(), $price­>getCurrency(

32. ADDRESSING
Address formats for 200 countries
Subdivisions (administrative areas, localities, dependent
localities) for 40 countries
Subdivision translations for all of the parent country's (i.e
Canada, Switzerland) official languages.
Validation (via Symfony Validator)
Form generation (via Symfony Form)
Postal formatting
Featured on the Drupal Commerce blog.

33. ADDRESS DATA
use CommerceGuysAddressingRepositoryAddressFormatRepository;
use CommerceGuysAddressingRepositorySubdivisionRepository;
$addressFormatRepository = new AddressFormatRepository();
$subdivisionRepository = new SubdivisionRepository();
// Get the address format for Canada.
$addressFormat = $addressFormatRepository­>get('CA');
// Get the subdivisions for Canada, in French.
$states = $subdivisionRepository­>getAll('CA', 0, 'fr');
foreach ($states as $state) {
echo $state­>getName();
}

34. WHAT FIELDS?

35. SOMEWHERE ELSE

36. ADDRESS FORMAT
Which fields are used, and in which order
Which fields are required
Which fields need to be uppercased
Field labels
Regular expression for validating postal codes

37. ADDRESS FORMATTING
use CommerceGuysAddressingFormatterPostalFormatter;
use CommerceGuysAddressingProviderDataProvider;
$dataProvider = new DataProvider();
$formatter = new PostalFormatter($dataProvider);
// Format an address for sending from Switzerland, in French.
// If the address destination is not Switzerland, the country name will be
// appended in French, uppercase.
echo $formatter­>format($address, 'CH', 'fr');

38. ZONE
Zones are territorial groupings mostly used for shipping or
tax purposes. For example, a set of shipping rates associated
with a zone where the rates become available only if the
customer's address matches the zone.
A zone can match other zones, countries, subdivisions
(states/provinces/municipalities), postal codes. Postal codes
can also be expressed using ranges or regular expressions.

39. Create the German VAT zone
use CommerceGuysAddressingModelAddress;
use CommerceGuysZoneModelZone;
use CommerceGuysZoneModelZoneMemberCountry;
$zone = new Zone();
$zone­>setId('german_vat');
$zone­>setName('German VAT');
$zone­>setScope('tax');

40. Add Germany to the zone,
$germanyZoneMember = new ZoneMemberCountry();
$germanyZoneMember­>setCountryCode('DE');
$zone­>addMember($germanyZoneMember);
add the 4 Austrian postal codes that are in Germany for VAT.
$austriaZoneMember = new ZoneMemberCountry();
$austriaZoneMember­>setCountryCode('AT');
$austriaZoneMember­>setIncludedPostalCodes('6691, 6991:6993');
$zone­>addMember($austriaZoneMember);

41. Initialising a zone matcher.
use CommerceGuysAddressingModelAddress;
use CommerceGuysZoneMatcherZoneMatcher;
use CommerceGuysZoneRepositoryZoneRepository;
$repository = new ZoneRepository('resources/zone');
$matcher = new ZoneMatcher($repository);

42. Create an address.
$austrianAddress = new Address();
$austrianAddress­>setCountryCode('AT');
$austrianAddress­>setPostalCode('6692');
Get the matching tax zones.
$zones = $matcher­>matchAll($austrianAddress, 'tax');
Is in Germany for VAT.

43. TAX
Smart data model designed for fluctuating tax rate
amounts ("19% -> 21% on January 1st").
Predefined tax rates and zones for EU countries, Iceland,
Norway, South Africa and Switzerland. More to come.
Tax resolvers with logic for all major use cases.

44. EU TAX RESOLVER
use CommerceGuysTaxRepositoryTaxTypeRepository;
use CommerceGuysTaxResolverEngineTaxTypeResolverEngine;
use CommerceGuysTaxResolverEngineTaxRateResolverEngine;
use CommerceGuysTaxResolverTaxTypeEuTaxTypeResolver;
use CommerceGuysTaxResolverTaxRateDefaultTaxRateResolver;
use CommerceGuysTaxResolverTaxResolver;
$taxTypeRepository = new TaxTypeRepository();
$taxTypeResolverEngine = new TaxTypeResolverEngine();
$taxTypeResolverEngine­>add(new EuTaxTypeResolver($taxTypeRepository));
$taxRateResolverEngine = new TaxRateResolverEngine();
$taxRateResolverEngine­>add(new DefaultTaxRateResolver());
$resolver = new TaxResolver($taxTypeResolverEngine, $taxRateResolverEngine);

45. CALCULATES THE VAT RATE BASED ON
Goods or Services
Type of service, digital, education
B2C or B2B
Supplier location
Customer Location

46. FULL DATA INC. HISTORIC RATES
{
"name": "British VAT",
"zone": "gb_vat",
"tag": "EU",
"rates": [
{
"id": "gb_vat_standard",
"name": "Standard",
"display_name": "% VAT",
"default": true,
"amounts": [
{
"id": "gb_vat_standard_1991",
"amount": 0.175,
"start_date": "1991­03­19",
"end_date": "2008­11­30"
},

47. WE'RE DOING SOMETHING RIGHT...

48. DRUPAL COMMERCE 2.X

49. DRUPAL COMMERCE 2.X SPRINT
Validated the architecture with members of SensioLabs,
Smile, Publicis Modem, OSInet, i-KOS, Adyax, Ekino, and
others.

50. ONCE AGAIN, WE START FROM SCRATCH
<?php
namespace DrupalcommerceEntity

53. 2.X ENTITY RELATIONSHIP MODEL

55. MULTI-STORE / MULTI-VENDOR

56. HIERARCHICAL PRODUCT MODEL

57. IMPROVED ORDER WORKFLOWS

59. IMPROVED PAYMENT PROCESSING
Create a "mini" ledger for payments with double entry like
accounting features.

63. TRY IT OUT

64. CONTRIBUTE ON GITHUB

65. QUESTIONS?
Office hours: Wednesdays at 1PM GMT
Find us in #drupal-commerce.