Laclic SovBundle

Administration basé sur EasyAdmin 3. Développé par la Clic!

Require :

• Symfony > 5.3
• EasyAdmin > 5.3
• FOS/Ckeditor-bundle: “^2.2”,

Instalation en version développement sur un projet :

Si tu démarres un nouveau projet il te suffit de cloner le projet : https://gitea.laclic.fr/Laclic/DefaultProjectSf5

• À la racine de ton projet créer un dossier Lc/AdminBundle/

• Dans le dossier Lc/AdminBundle :

  git clone https://gitea.laclic.fr/Laclic/AdminBundle.git .
  

• Initialisation :

  • Création des entités de base, créer une entité User.php et File.php, ajouter dans la configuration de doctrine les lignes suivantes

    doctrine:
    orm:
    resolve_target_entities:
      Lc\SovBundle\IModel\User\UserInterface: App\Entity\User
      Lc\SovBundle\Doctrine\Extension\FileInterface: App\Entity\File  
    #...
    

• Instalation ckeditor php bin/console ckeditor:install `php bin/console assets:install public

• Créer la config fos_ckeditor.yaml ``` fos_ck_editor: input_sync: true default_config: base_config configs:

  base_config:
      filebrowserBrowseRoute: file_manager
      filebrowserBrowseRouteParameters:
              conf: default
              module: ckeditor
      format_tags: 'p;h2;h3'
      toolbar:
          - { name: "styles", items: ['Bold', 'Italic','Underline', 'Strike']}
          - { name: "paragraph", items: ['Format', 'NumberedList', 'BulletedList', '-', 'Outdent', 'Indent', '-', 'Blockquote'] }
          - { name: "link", items: [ 'Link', 'Unlink'] }
          - {name: 'insert', items: [ 'Image' ]}
          - {name: 'document', items: [ 'Source' ]}
  simple_config:
      toolbar:
          - { items: ['Bold', 'Italic', 'Underline', 'Colors', 'Source'] }
  

  twig: form_themes:

• ’@FOSCKEditor/Form/ckeditor_widget.html.twig’

- Créer la config artgris_file_manager.yaml

artgris_file_manager:

conf:
    default:
        dir: "../public/uploads"
        type: 'image'

```

• Enjoy !

Pour les projet Aquarium, Laclic, Le plat pentu (et peut être d’autres) suit cette préocédure :

• Compare ton .gitignore avec le gitignore de DefaultProjectSf5 et ajoute les lignes manquantes

• Modifier composer.json dans “autoload” ajouter :

  "autoload": {
      "psr-4": {
          "App\\": "src/",
          "Lc\\": "Lc/"
      }
  },
  

• Dans le dossier config de ton projet :

  • Modifier bundles.php et ajouter : Lc\SovBundle\SovBundle::class => ['all' => true],
  • Modifier services.yaml et ajouter : Lc\SovBundle\: resource: '../Lc/AdminBundle/' exclude: - '../Lc/AdminBundle/DependencyInjection/' - '../Lc/AdminBundle/Entity/' - '../Lc/AdminBundle/Kernel.php' - '../Lc/AdminBundle/Tests/' et Lc\SovBundle\Controller\: resource: '../Lc/AdminBundle/Controller/' tags: ['controller.service_arguments']
  • Modifier packages/security.yml guard: authenticators: - Lc\SovBundle\Authenticator\LoginFormAuthenticator
  • Modifier packages/doctrine.yaml resolve_target_entities: Lc\SovBundle\IModel\User\UserInterface: App\Entity\User
  • Modifier routes.yaml login: path: /login controller: Lc\SovBundle\Controller\Admin\SecurityController::login logout: path: /logout controller: Lc\SovBundle\Admin\SecurityController::logout
    

• Dans le dossier src/ de ton projet :

  • Supprimer Controller/Admin/SecurityController.php.
  • Supprimer Controller/Admin/AbstractCrudController.php.
  • Modifier l’en tête de Controller/Admin/DashboardController.php. ```` use Lc\SovBundle\Controller\Admin\DashboardController as LcDashboardController;
    

  class DashboardController extends LcDashboardController { // … le code spécifique }

  
  - Modifier l'en tête des controllers. Exemple  `Controller/Admin/PageCrudController.php`.
  

  use Lc\SovBundle\Controller\AbstractAdminController as AbstractCrudController;

  class PageCrudController extends AbstractCrudController { // … le code spécifique }

  - Modifier `Entity/User.php`.
  

  <?php

  namespace App\Entity;

  use Doctrine\ORM\Mapping as ORM; use Lc\SovBundle\Model\User\UserInterface; use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity; use Lc\SovBundle\Model\User\User as LcUserModel;

  /**

  • @ORM\Entity(repositoryClass=“Lc\SovBundle\Repository\User\UserRepository”)

  • @UniqueEntity(fields={“email”}, message=“There is already an account with this email”) */ class User extends LcUserModel implements UserInterface { /**

    • @ORM\Id
    • @ORM\GeneratedValue
    • @ORM\Column(type=“integer”) */ private $id;
      

    public function getId(): ?int {

       return $this->id;
    

    }

  }

  - Modifier les entités pour que les Use pointe dans AdminBundle exemple avec `Entity/Page.php`.
  

  use Lc\SovBundle\Doctrine\Extension\ImageInterface; use Lc\SovBundle\Model\Cms\AbstractDocument; use Lc\SovBundle\Model\Cms\ImageTrait;

  /**

  • @ORM\Entity(repositoryClass=PageRepository::class) */ class Page extends AbstractDocument implements ImageInterface { use ImageTrait;
    

  // … le code spécifique

  }

  
  - Modifier les repository pour qu'il fonctionne avec AdminBundle exemple avec `Repository/PageRepository.php.php`.
  

  <?php

  namespace App\Repository;

  use App\Entity\Page; use Lc\SovBundle\Repository\RepositoryAbstract;

  /**

  • @method Page|null find($id, $lockMode = null, $lockVersion = null)
  • @method Page|null findOneBy(array $criteria, array $orderBy = null)
  • @method Page[] findAll()

  • @method Page[] findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null) */ class PageRepository extends RepositoryAbstract { public function getInterfaceClass() {

     return Page::class;
    

    }

    // … le code spécifique }

  - Supprimer `Repository/UserRepository.php.php`.
  Sauf si il contient des fonctions autres que `__contruct()` et `upgradePassword-()`
  Si c'est le cas le réécrire en faisant un extends de UserRepository dans AdminBundle
      
  - Faire un `composer install`
  - Tester l'application connectes toi à l'admin, édites un doc ou deux
  - Si tout est ok tu peux supprimer les dossiers :
  

  src/IModel/ src/Model/ src/Security/ src/Command/