Download the PHP package tailsfadmin/tailsfadmin-bundle without Composer

On this page you can find all versions of the php package tailsfadmin/tailsfadmin-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of tailsfadmin/tailsfadmin-bundle

Informations about the package tailsfadmin-bundle

tailsfadmin

Packagist Version Total Downloads CI

Thème admin Symfony basé sur TailAdmin — bundle réutilisable (Symfony UX, Stimulus, AssetMapper, Tailwind CSS v4).

Architecture du monorepo

Ce dépôt suit la structure définie dans ADR-002 :

Règle d'isolation bundle / démo (DoD §6)

IMPORTANT : aucun code réutilisable ne doit vivre dans demo/. La démo ne contient que de l'usage du bundle. Toute logique partageable appartient à src/.

Prérequis

Installation (développement — path repository)

Installation depuis Packagist (projet tiers)

Le bundle est activé automatiquement par Symfony Flex.

Configuration & prise en main

1. Assets (AssetMapper + importmap)

Les contrôleurs Stimulus du bundle vivent sous bundles/tailsfadmin. Stimulus doit être démarré côté hôte (assets/bootstrap.js du skeleton). Déclarez le path AssetMapper des contrôleurs dans votre config/packages/asset_mapper.yaml (le prepend() du bundle ne survit pas au merge Flex ; la recette Flex — à venir — l'automatisera) :

Dépendances JS tierces — commande d'installation. Cinq contrôleurs du bundle s'appuient sur des bibliothèques tierces (ApexCharts, jsvectormap, flatpickr, Dropzone, FullCalendar). Un bundle ne peut pas injecter d'entrées dans l'importmap.php de l'hôte (l'importmap n'est pas une config mergeable — voir ADR-007). Le bundle fournit donc une commande qui ajoute ces pins et vendore les fichiers localement :

Compilez ensuite les assets :

Les contrôleurs sans dépendance externe (theme, sidebar, modal, dropdown, alert-dismiss, preloader, search, submenu) fonctionnent sans cette commande, via le seul path AssetMapper.

2. Thème CSS (Tailwind hôte)

Le bundle distribue son thème (tokens @theme, dark mode, classes composants .menu-item*…) dans assets/styles/theme.css. Votre app le branche en une seule ligne, dans sa propre entrée Tailwind v4 — sans recopier les tokens ni le CSS des composants :

Besoin d'une entrée « tout-en-un » (Tailwind + thème) ? Importez plutôt assets/styles/app.css du bundle. La démo (demo/assets/styles/app.css) illustre le pattern hôte ci-dessus.

3. Menu de la sidebar (config/packages/tailsfadmin.yaml)

Les label sont des clés de traduction (voir i18n ci-dessous) ou des libellés bruts :

Filtrage par permission (optionnel). Chaque item (et sous-item) accepte une clé permission. Si un composant de sécurité Symfony est installé, les items dont l'utilisateur courant n'a pas l'autorisation sont masqués (is_granted), et un groupe entièrement filtré n'est pas rendu. Sans sécurité, tout reste visible.

Le MenuBuilder reçoit @?security.authorization_checker (injection optionnelle, aucune dépendance dure). Pour l'activer, installez symfony/security-bundle.

4. Layout d'une page

Le layout attend une route nommée home (logo de la sidebar) et locale_switch si vous utilisez le sélecteur de langue.

Personnaliser le header. Le composant tsf:Layout:Header expose des blocs surchargeables — language, notifications, user_menu — pour brancher un vrai menu utilisateur (déconnexion + CSRF), un flux de notifications réel, ou retirer le sélecteur de langue si l'application ne définit pas de route locale_switch. Surchargez {% block header %} du layout avec le composant et vos slots :

5. Internationalisation (optionnel)

Installez symfony/translation, réglez framework.default_locale + enabled_locales, et fournissez vos catalogues. Le bundle expose ses propres traductions du chrome (header, breadcrumb…) et les helpers Twig tsf_dir() / tsf_locales().

6. Catalogue des composants

Tous les composants <twig:tsf:… /> (props, slots, exemples) sont documentés dans docs/components.md ; une galerie vivante est servie sur /ui-kit dans la démo.

Commandes de développement

Le versionnement suit SemVer ; les évolutions sont consignées dans CHANGELOG.md (format Keep a Changelog).

Vérifications DoD

Docker / FrankenPHP

La démo peut aussi être lancée via Docker Compose, sous FrankenPHP / PHP 8.5, pour garantir un environnement reproductible (local = CI). Voir demo/Dockerfile et compose.yaml pour le détail de l'image.

Démarrer / arrêter

L'application est ensuite disponible sur http://localhost/.

Vérifier le conteneur

Changer le port hôte (erreur « port déjà utilisé »)

Si le port 80 (ou 443) est déjà occupé sur la machine hôte, définir HOST_HTTP_PORT / HOST_HTTPS_PORT avant de lancer la commande :

Ces variables peuvent aussi être placées dans un fichier .env à la racine du dépôt (non versionné) pour éviter de les répéter à chaque commande.

Utilisation hors-ligne (pré-pull de l'image)

L'image de base dunglas/frankenphp:php8.5 peut être téléchargée à l'avance, par exemple avant un déplacement sans accès réseau ou pour accélérer un premier build :

Le docker compose up --build suivant réutilisera l'image déjà présente en cache local pour l'étape FROM, sans nouveau téléchargement.

Stack technique

Couche Technologie
Backend PHP 8.5, Symfony 8.1, AbstractBundle
Frontend Stimulus / Symfony UX, AssetMapper
CSS Tailwind CSS v4
Tests PHPUnit 12, WebTestCase
Qualité PHPStan max, PHP CS Fixer (PSR-12)

Licence

MIT — voir LICENSE

All versions of tailsfadmin-bundle with dependencies

PHP Build Version
Package Version
Requires php Version >=8.2
symfony/asset Version ^7.3 || ^8.0
symfony/asset-mapper Version ^7.3 || ^8.0
symfony/console Version ^7.3 || ^8.0
symfony/form Version ^7.3 || ^8.0
symfony/framework-bundle Version ^7.3 || ^8.0
symfony/stimulus-bundle Version ^2.20 || ^3.0
symfony/translation Version ^7.3 || ^8.0
symfony/ux-twig-component Version ^2.0 || ^3.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tailsfadmin/tailsfadmin-bundle contains the following files

Loading the files please wait ...