Brontekst bekijken van Installatie Drupal Commerce 2.x - Casus begin 2017

Zie ook 

* [[Composer]]
* [[Drupal Console]]
* [[Installatie Drupal Commerce 2.x - Casus begin 2017 (2)]]
* [[Installatie Drupal Commerce 2.x - Casus begin 2017 (3)]]
* [[Installatie Drupal Commerce 2.x - Algemeen]]

Er is geen ontkomen aan: ''Drupal Commerce'' kun je alleen via ''Composer'' installeren [https://www.drupal.org/project/commerce], [https://www.youtube.com/watch?v=XOy0sR9NPxM]. Daarmee wordt het terminal-commando ''composer'' bedoeld, niet de Drupal-module. Je kunt Drupal Commerce 2.x dus waarschijnlijk alleen installeren als je terminal-toegang hebt.

== Requirements ==

Zie de casus hieronder voor details. Deze lijst is niet compleet. Ook is er niet aangegeven welke dingen je expliciet zelf moet regelen.

=== Composer ===

Je hebt de command-line tool ''composer'' nodig. Niet de Drupal-module met dezelfde naam!

=== Drupal-modules ===

* [https://drupal.org/project/address Address]
* [https://drupal.org/project/entity Entity]
* [https://drupal.org/project/state_machine State Machine]
* [https://drupal.org/project/inline_entity_form Inline Entity Form]
* [https://drupal.org/project/profile Profile]

* Zie hieronder + [http://docs.drupalcommerce.org/v2/]
* Zie de casus hieronder voor meer afhankelijkheden.

=== PHP-libraries - Algemeen ===

''' php-bcmath '''

Deze module heb je al bij de installatie nodig, maar ook later tijdens aanmaak van producten. Deze installatie speelde zich af op een redelijk frisse LAMP-server. Oorspronkelijk probeerde ik php 7.1 te gebruiken, maar toen die moeilijk deed, ben ik overgestapt op php  7.0, althans dat dacht ik;

Oorspronkelijke installatie: <code>sudo apt-get install php-bcmath</code>. Dat bleek echter de php 7.1-versie te installatie. De php 7.0-versie geïnstalleerd middels <code>sudo apt-get install php7.0-bcmath</code>

''' php-gd '''

Installatie voor PHP 7.1:

 sudo apt-get install gd

Installatie voor PHP 7.0:

 sudo apt-get install php7.0-gd

=== PHP-libraries - Specifiek ===

* [https://github.com/commerceguys/intl commerceguys/intl]
* [https://github.com/commerceguys/addressing commerceguys/addressing]
* [https://github.com/commerceguys/zone commerceguys/zone]
* [https://github.com/commerceguys/tax commerceguys/tax]

=== Drupal Console ===

[https://drupalconsole.com/ Drupal Console] wordt aangeraden.

== Installatie Drupal Commerce ==

* Basissite geïnstalleerd mbv. eigen script
* Composer geïnstalleerd middels <code>sudo apt-get install composer</code>
* Vanuit de root van die installatie: <code>composer config repositories.drupal composer https://packages.drupal.org/8</code> - Geen foutmeldingen
* <code>composer require "drupal/commerce 2.x-dev"</code> gaf foutmelding:

<pre>
Problem 1
    - easyrdf/easyrdf 0.9.1 requires ext-mbstring * -> the requested PHP extension mbstring is missing from your system.
    - easyrdf/easyrdf 0.9.1 requires ext-mbstring * -> the requested PHP extension mbstring is missing from your system.
    - easyrdf/easyrdf 0.9.1 requires ext-mbstring * -> the requested PHP extension mbstring is missing from your system.
    - Installation request for easyrdf/easyrdf == 0.9.1.0 -> satisfiable by easyrdf/easyrdf[0.9.1].
</pre>

* <code>sudo apt-get install php-mbstring</code>
* <code>composer require "drupal/commerce 2.x-dev"</code>. Gelukt zonder foutmelding, met veel output
* <code>drupal module:install commerce_product commerce_checkout commerce_cart commerce_tax</code> geeft foutmelding: Commando ''drupal'' is niet bekend
* [[Drupal Console]] Geïnstalleerd
* <code>drupal module:install commerce_product commerce_checkout commerce_cart commerce_tax</code> - Opnieuw foutmelding: Je moet Drupal Console ook locaal installeren per instantie:
* <code>composer require drupal/console:~1.0 --prefer-dist --optimize-autoloader</code>
* <code>composer update drupal/console --with-dependencies</code>: Wat onduidelijke waarschuwingen over ''whitelisting'', maar verder ok
* <code>drupal module:install commerce_product commerce_checkout commerce_cart commerce_tax</code> - gelukt. Output:

<pre>
One or more modules "commerce_tax" are not available, running download process to get those modules
 Getting releases for module "commerce_tax"
                                                                                                                        
 [ERROR] There aren't any releases for module "commerce_tax"                                                            
 [ERROR] Invalid module name: commerce_tax                                                                              

 Installing module(s) "commerce_product, commerce_checkout, commerce_cart, commerce, address, entity, inline_entity_form, commerce_price, commerce_store, commerce_order, entity_reference_revisions, profile, state_machine"
                                                                                                                        
 [OK] The following module(s) were installed successfully: "commerce_product, commerce_checkout, commerce_cart,         
      commerce, address, entity, inline_entity_form, commerce_price, commerce_store, commerce_order,                    
      entity_reference_revisions, profile, state_machine"                                                               

 // cache:rebuild
 Rebuilding cache(s), wait a moment please.
 [OK] Done clearing cache(s).
</pre>

== Updaten ==

=== Eerst Drupal Commerce updaten ===

Updaten van Drupal Commerce gaat via:

 composer update drupal/commerce --with-dependencies

=== Daarna de rest updaten ===

Updaten van de site-als-geheel via Drupal Console (''ná'' updaten Drupal Commerce!):

 drupal update:debug
 drupal update:execute

== Installatie additionele modules ==

Dat gaat op de gebruikelijke manier, lijkt me. Alleen officiele Drupal Commerce modules gaan via Composer. Tot op dit moment nog geen additionele modules geïnstalleerd.

== Configuratie Drupal ==

=== CKEditor uitzetten ===

 Administration » Configuration » Content authoring » Text format & Editors

Gelukkig: Er worden nu ook geen HTML-tags meer ongevraagd toegevoegd!

=== Full HTML als standaard instellen (voor admin) ===

Zelfde link als hierboven: De volgorde aanpassen van de formats.

=== 'Powered by Drupal'-block verwijderen ===

Gewoon onder ''Strucure''.

=== Plugin not found-error bij uploaden afbeelding ===

''' Foutmelding '''

<pre>
Drupal\Component\Plugin\Exception\PluginNotFoundException: 
The "" plugin does not exist. 
in Drupal\Core\Plugin\DefaultPluginManager->doGetDefinition() 
(line 52 of core/lib/Drupal/Component/Plugin/Discovery/DiscoveryTrait.php)
</pre>

''' Installatie file_browser '''

Ik had de indruk dat de installatie van de dev-versie van ''file_browser'' zou kunnen helpen. Drie libraries en vijf moduled verder, bleek dat niet het geval te zijn → Al die zooi weer verwijderd.

''' Overig '''

* Clearing cache hielp niet

''' Oplossing '''

Wéér had ik van een module de PHP 7.1-versie ipv. de PHP 7.0-versie. 

 sudo apt-get install php7.0-gd
 sudo service apache2 restart

En het probleem was verholpen.

== Valuta & store ==

=== Valuta ===

* Eerst valuta, dan ''stores''
* Alleen euro

=== Store ===

Je moet eerst een ''store'' configureren voordat je met producten aan de slag kunt

== Producten, variaties & representaties ==

Er een gelaagd systeem van producten en de weergave daarvan. Enkele termen die zoal een rol spelen:

* ''Product type'' - Waarschijnlijk wat ik P1 noem. Bv. t-shirts
* ''Products'' of ''product variations'' - Bv. een fysiek t-shirt met een bepaalde kleur en maat
* ''Product attributes'' - Bv. kleur (rood, zwart), en maat (S, M, L)
* ''Purchasable entities'' - ?
* ''Product fields'' - Los van product attributes, kun je producten opleuken met allerlei velden

Dit systeem heeft iets weg van dat voor DC1 [http://internetdevels.com/blog/the-commerce-2x-module-for-Drupal-8]:

* P1: ''Commerce Product'' → ''ProductVariation''
* P2: ''Product display'' → ''Product''

=== Product attributes ===

Bij ''product attributes'' moet je denken aan bv. verschillende maten of kleuren. Definitie gaat via <code>Admin » Commerce » Product attributes</code>. Product attributes staan in dit stadium helemaal los van producten of wat dan ook. Ze moeten nog gekoppeld worden.

{|
|[[file:20170313-1556.png|thumb|'''Product attributes:''' <code>Admin » Commerce » Product attributes</code>: Geen ''product attributes'' gedefineerd: Alle producten in deze webwinkel zijn wat dat betreft uniform]]
|}

=== Product variation type ===

Door ''product attributes'' te associeren met ''producten'', krijg je ''product variation types''. Ook als je geen gebruik maakt van product attributes, schijn je tenminste één product variation type nodig (we gaan het zien). Je vindt ze onder [http://docs.drupalcommerce.org/v2/product/product-attributes.html]

 Admin » Commerce » Configuration » Product variation types

{|
|[[file:20170313-1557.png|thumb|'''Product variation type:''' <code>Admin » Commerce » Configuration » Product variation type</code>: Geen ''product variation'' gedefineerd: Ik ben benieuwd of dat geen probleem is]]
|}

=== Product types ===

Naast ''product variation types'' heb je ook nog ''product types''. Daar lijk je product variaties te associeren met kale producttypes, en niet bij ''product variation type'' ofzoiets. Voor nu geloof ik het wel.

=== Product Variants ===

De handleiding legt oa. [http://docs.drupalcommerce.org/v2/product/products.html hier] uit, dat je altijd minimaal één productvariant moet defineren.

{|
|[[file:20170313-1639.png|thumb|'''Met product variant:''' [http://docs.drupalcommerce.org/v2/product/products.html Illustratie] dat je echt minimaal één product variant moet hebben, voor prijs en SKU]]
|[[file:20170313-1558.png|thumb|'''Zonder product variant:''' <code>Commerce » Products</code>: ''Products'' zonder product variations of wat dan ook. Kaler dan dit krijg je 't waarschijnlijk niet. Maar zo zonder prijs is wel héél kaal]]
|}

{|
|[[file:20170313-1647.png|thumb|'''Met 'reguliere' product variant (1):''' In dit geval is er één veld toegevoegd, namelijk voor productafbeeldingen. Hier kun je zien dat ''productvarianten'' nog het beste overeenkomen met wat ik '''P2''' noemde in DC1: De presentatie van producten (al is presentatie nu niet meer een accurate benaming)]]
|[[file:20170313-1648.png|thumb|'''Met 'reguliere' product variant (2):''' Nu kun je prijzen, SKU en afbeeldingen associëren met producten]]
|}

=== P1-definitie aanpassen ===

Zo uit de doos, is P1 nogal kaal. Onder andere is het wel geinig om 'm op te luisteren met een productafbeelding:

''' Productafbeeldingen '''

* Naam: <code>p1_image</code>
* Aantal: Onbeperkt.

P.s.: Ik weet niet meer waar ik dit heb gedaan.

=== Producten ===

Zo snel je een product type (of zoiets) hebt gedefineerd, kun je producten toevoegen:

 Commerce » Products

=== Foutmelding: Field variations is unknown ===

Oh oh:

<pre>
The website encountered an unexpected error. Please try again later.

InvalidArgumentException: Field variations is unknown. 
in Drupal\Core\Entity\ContentEntityBase->getTranslatedField() 
(line 471 of core/lib/Drupal/Core/Entity/ContentEntityBase.php).
</pre>

Dit lijkt een bug te zijn op het snijvlak van Drupal Commerce en iets met talen. De producten worden wél opgeslagen, maar ik kan ze daarna niet 'gewoon' bekijken. Dus negeren is geen optie. Een mogelijke tijdelijke oplossing: Meertaligheid uitzetten → Producten invoeren → Dan pas iets met meertaligheid doen.

Desalniettemin: Voordat ik deze webshop ontdaan had van allerlei toeters en bellen, deed deze pagina 't wel. In het bijzonder: De handleiding zegt regelmatig (oa. [http://docs.drupalcommerce.org/v2/product/products.html hier] dat je minimaal één ''productvariant'' nodig hebt.

=== Manage display (P2) ===

De ''presentatie'' van producten noem ik '''P2''', vanwege de verwarrende naamgeving. Deze kun je op twee plekken aanpassen:

* <code>Admin » Commerce » Config » Product type</code>
* <code>Admin » Commerce » Config » Product variation type</code>

=== Products » Add product ===

Foutmelding: 

<pre>
RuntimeException: The bcmath extension is required by NumberFormatter. 
in CommerceGuys\Intl\Formatter\NumberFormatter->__construct() 
(line 113 of vendor/commerceguys/intl/src/Formatter/NumberFormatter.php).
</pre>

== Overig ==

* In DC2 kun je meerdere ''stores'' configureren. Daardoor schijn je ''marktplaatsen'' te kunnen bouwen [http://docs.drupalcommerce.org/v2/store.html]

== Bronnen ==

* https://www.drupal.org/node/2351795 - Drupal Commerce 2.x Advanced Installation Instructions
* https://www.drupal.org/node/2405811 - Composer Manager for Drupal 8 » Bijzaak
* https://www.youtube.com/watch?v=XOy0sR9NPxM - Commerce 2.x Download and Install on Drupal 8, Part 1 of 2 (june 2016)
* https://www.youtube.com/watch?v=CrJrjgOuvSk - Commerce 2.x Download and Install on Drupal 8, Part 2 of 2 (june 2016)
* https://pantheon.io/drupal-8/introduction-drush-and-drupal-console
* http://ckeditor.com/slides/ckeditor-in-drupal-8

''' Plugin not found-error '''

* https://www.drupal.org/node/2716785#comment-11964386 - Goed antwoord, van een leuke vent

''' Field variations-error '''

* https://www.drupal.org/node/2835576 - InvalidArgumentException: Field uuid is unknown
* https://www.drupal.org/node/2837547 - Product creation failed

''' Configuratie Drupal Commerce '''

* http://internetdevels.com/blog/the-commerce-2x-module-for-Drupal-8 - Hele procedure: Aardig!
* http://docs.drupalcommerce.org/v2/currency.html
* https://www.drupal.org/node/2816739 - Unable to create New products, (Unexpected Error)
* http://docs.drupalcommerce.org/v2/product/index.html - Products, attributes, purchasable entities
* http://docs.drupalcommerce.org/v2/product/product-attributes.html