madcoders/setono-sylius-terms-plugin

Sylius terms and conditions plugin

Installs: 754

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 7

Type:sylius-plugin


README

This is fork of Setono/SyliusTermsPlugin

Extended functionality

  • you can enable/disable each entry
  • you can decide where Terms are displayed: checkout, customer registration form, footer (as link)
  • position field to sort terms (if more than one used in the same area)
  • upgraded development env to Sylius 1.10

There are 2 additional installation steps (comparing to original README):

Step 7: Override customer registration form

Override the Sylius Form:

  • If you haven't your own templates/bundles/SyliusShopBundle/Register/_form.html.twig yet:

    $ cp vendor/sylius/sylius/src/Sylius/Bundle/ShopBundle/Resources/views/Register/_form.html.twig \
    templates/bundles/SyliusShopBundle/Register/_form.html.twig
  • If you already have it:

    Add terms field (exactly this conditional way):

    {# templates/bundles/SyliusShopBundle/Register/_form.html.twig#}
    {% if form.terms is defined %}
        {% form_theme form.terms '@SetonoSyliusTermsPlugin/Shop/Form/termsTheme.html.twig' %}
        {{ form_row(form.terms) }}
    {% endif %}

    So the final template will look like this:

    {# templates/bundles/SyliusShopBundle/Register/_form.html.twig#}
    <h4 class="ui dividing header">{{ 'sylius.ui.personal_information'|trans }}</h4>
    <div class="two fields">
        {{ form_row(form.firstName, sylius_test_form_attribute('first-name')) }}
        {{ form_row(form.lastName, sylius_test_form_attribute('last-name')) }}
    </div>
    {{ form_row(form.email, sylius_test_form_attribute('email')) }}
    {{ form_row(form.phoneNumber, sylius_test_form_attribute('phone-number')) }}
    {{ form_row(form.subscribedToNewsletter, sylius_test_form_attribute('subscribed-to-newsletter')) }}
    <h4 class="ui dividing header">{{ 'sylius.ui.account_credentials'|trans }}</h4>
    {{ form_row(form.user.plainPassword.first, sylius_test_form_attribute('password-first')) }}
    {{ form_row(form.user.plainPassword.second, sylius_test_form_attribute('password-second')) }}
    {% if form.terms is defined %}
        {% form_theme form.terms '@SetonoSyliusTermsPlugin/Shop/Form/termsTheme.html.twig' %}
        {{ form_row(form.terms) }}
    {% endif %}

Step 8: Override footer block

Override the Sylius Template Block:

  • If you haven't your own templates/bundles/SyliusShopBundle/Layout/Footer/Grid/_your_store.html.twig yet:

    $ cp vendor/sylius/sylius/src/Sylius/Bundle/ShopBundle/Resources/views/Layout/Footer/Grid/_your_store.html.twig \
    templates/bundles/SyliusShopBundle/Layout/Footer/Grid/_your_store.html.twig
  • If you already have it:

    Add terms field (exactly this conditional way):

    {# templates/bundles/SyliusShopBundle/Layout/Footer/Grid/_your_store.html.twig #}
    {% set terms = footer_terms_view() %}
    {% if terms is defined and terms is not null %}
        {% for term in terms %}
            {{ footer_term_link(term, sylius.localeCode) }}
        {% endfor %} 
    {% endif %}

    So the final template will look like this:

    {# templates/bundles/SyliusShopBundle/Layout/Footer/Grid/_your_store.html.twig #}
    <div class="four wide column">
        <h4 class="ui inverted header">{{ 'sylius.ui.your_store'|trans }}</h4>
        <div class="ui inverted link list">
            <a href="#" class="item">{{ 'sylius.ui.about'|trans }}</a>
            {% set terms = footer_terms_view() %}
            {% if terms is defined and terms is not null %}
                {% for term in terms %}
                    {{ footer_term_link(term, sylius.localeCode) }}
                {% endfor %}
            {% endif %}
            <a href="{{ path('sylius_shop_contact_request') }}" class="item">{{ 'sylius.ui.contact_us'|trans }}</a>
        </div>
    </div>

There's pull request open which greatly summarizes changes: Setono#48

------- ORIGINAL PLUGIN'S README starts here --------

Will add the requirement to check off terms and conditions when the customer checks out

Screenshots

Shop

Before the customer can place order, he/she has to check the required terms

Screenshot showing shop checkout complete page

Admin

Here is a list of terms. Notice the terms_and_conditions which is associated with multiple channels.

Screenshot showing admin terms index page

Screenshot showing admin terms update page

The Explanation field is the text shown on the complete order page. Notice you can use a placeholder ([link:Link text]) to tell where the link should be.

Screenshot showing admin terms translation update page

Installation

Step 1: Download the plugin

Open a command console, enter your project directory and execute the following command to download the latest stable version of this plugin:

$ composer require setono/sylius-terms-plugin

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the plugin

Then, enable the plugin by adding it to the list of registered plugins/bundles in the config/bundles.php file of your project:

<?php
# config/bundles.php
return [
    // ...
    
    Setono\SyliusTermsPlugin\SetonoSyliusTermsPlugin::class => ['all' => true],
    
    // It is important to add plugin before the grid bundle
    Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true],
    
    // ...
];

NOTE that you must instantiate the plugin before the grid bundle, else you will see an exception like You have requested a non-existent parameter "setono_sylius_terms.model.terms.class".

Step 3: Import config

# config/packages/_sylius.yaml
imports:
    # ...
    
    - { resource: "@SetonoSyliusTermsPlugin/Resources/config/app/config.yaml" }
    
    # ...

Step 4: Import routing

# config/routes/setono_sylius_terms.yaml

setono_sylius_terms_shop:
    resource: "@SetonoSyliusTermsPlugin/Resources/config/shop_routing.yaml"
    prefix: /{_locale}
    requirements:
        _locale: ^[a-z]{2}(?:_[A-Z]{2})?$

setono_sylius_terms_admin:
    resource: "@SetonoSyliusTermsPlugin/Resources/config/admin_routing.yaml"
    prefix: /admin

Step 5: Update your database schema

$ php bin/console doctrine:migrations:diff
$ php bin/console doctrine:migrations:migrate

Step 6: Override checkout complete form

Override the Sylius Form:

  • If you haven't your own templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig yet:

    $ cp vendor/sylius/sylius/src/Sylius/Bundle/ShopBundle/Resources/views/Checkout/Complete/_form.html.twig \
    templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig
  • If you already have it:

    Add terms field (exactly this conditional way):

    {# templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig #}
    {% if form.terms is defined %}
        {% form_theme form.terms '@SetonoSyliusTermsPlugin/Shop/Form/termsTheme.html.twig' %}
        {{ form_row(form.terms) }}
    {% endif %}

    So the final template will look like this:

    {# templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig #}
    {{ form_row(form.notes, {'attr': {'rows': 3}}) }}
    {% if form.terms is defined %}
        {% form_theme form.terms '@SetonoSyliusTermsPlugin/Shop/Form/termsTheme.html.twig' %}
        {{ form_row(form.terms) }}
    {% endif %}

Troubleshooting

  • If you see Neither the property "terms" nor one of the methods "terms()", "getterms()"/"isterms()"/"hasterms()" or "__call()" exist and have public access in class "Symfony\Component\Form\FormView".

    Then see Setono#13 and double-check you added terms field at template like described at Override checkout complete form section.

  • If you see Grid "setono_sylius_terms_terms" does not exists

    Then you forgot to import config from Step 3: Import config section.

  • If you see Uncaught ReferenceError: $ is not defined in your js console

    This means jQuery was loaded after plugin's javascript code. Plugin's javascript code injecting into main template via sylius.shop.layout.javascripts Sonata block. So check your custom templates/bundles/SyliusShopBundle/layout.html.twig it's javascript block should be like this:

    {# layout.html.twig #}
    
    {% block javascripts %}
        // We expect jquery to be loaded here
        {% include '@SyliusUi/_javascripts.html.twig' with {'path': 'assets/shop/js/app.js'} %}
    
        // But if you have it as separate script - just make sure
        // it placed before `sylius.shop.layout.javascripts` sonata block
    
        {{ sonata_block_render_event('sylius.shop.layout.javascripts') }}
    {% endblock %}