{% extends '00_bases/base.html.twig' %}

{% block title %}Installation{% endblock %}

{% block body %}
<div class="example-wrapper">

  <h1>Installation du bundle</h1>

  <div class="oka-spacer -md"></div>


    <p>Ajouter dans le <code>composer.json</code></p>
    <pre><code>"repositories": [{
    "type": "vcs",
    "url": "http://srv-gitlab.hokoha.local/CODE_SOURCE/hokoha-libs/web/symfony/bundles/listes.git" // lien vers le .git du bundle
}]</code></pre>
    <p>Dans le <code>composer.json</code> ajouter dans le <code>config</code>: <code>"secure-http": false</code></p>

    <p>Pour permettre aux docker de dev d'accéder au nom de domaine, il faut rajouter au niveau du container du <code>docker-compose.yml</code>:</p>
    <pre><code>    www:
        extra_hosts:
            - "gitlab.com:172.17.17.110"
            - "SRV-GITLAB.HOKOHA.local:172.17.17.110"</code></pre>

    <p>Faites un <code>docker compose up -d</code> pour recréer le container avec la bonne configuration.</p>
    <p>Ensuite, installer le bundle avec <code>composer require hokoha/lists-bundle</code></p>

    <p>Ajouter dans le <code>head</code> de votre page: <code>{% verbatim %}{{ listsJavascript() }}{% endverbatim %}</code></p>

    <p>Ajouter dans le template twig gérant les formulaires: <code>{% verbatim %}{% use '@Lists/form/forms.html.twig' %}{% endverbatim %}</code></p>

    <h3>Utilisation</h3>

    <p>Pour créer une listes, créer d'abord une configuration dans le .yaml et ensuite récupérer l'instance de la factory en utilisant l'autowiring de symfony.</p>
    <p>Une fois la construction de la liste terminé, faites un <code>$list->build()</code> pour la construire et ainsi la passer au template twig.</p>
    <p>Dans le template Twig, utiliser <code>{% verbatim %}{{renderlist(list)}}{% endverbatim %}</code> pour afficher et insérer la liste où vous le souhaitez.</p>
</div>


{% endblock %}