PHPackages                             uccello/plugin-resource-transfer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. uccello/plugin-resource-transfer

ActiveLibrary

uccello/plugin-resource-transfer
================================

Filament plugin that allows you to export and import Filament resources along with their related data and attached files between Laravel projects

03↑2900%PHPCI passing

Since Dec 24Pushed 2mo agoCompare

[ Source](https://github.com/uccellolabs/filament-export)[ Packagist](https://packagist.org/packages/uccello/plugin-resource-transfer)[ RSS](/packages/uccello-plugin-resource-transfer/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

Plugin Resource Transfer
========================

[](#plugin-resource-transfer)

Un plugin Filament permettant d'exporter et d'importer des ressources Filament avec leurs fichiers associés entre projets Laravel.

Installation
------------

[](#installation)

### Installation locale (développement)

[](#installation-locale-développement)

Si le package n'est pas encore publié sur Packagist, ajoutez-le comme repository local dans le `composer.json` de votre projet Laravel :

```
{
    "repositories": [
        {
            "type": "path",
            "url": "f:/Ucello/packages/filament-export/plugin-resource-transfer"
        }
    ]
}
```

Ensuite, installez le package :

```
composer require uccello/plugin-resource-transfer:@dev
```

### Installation via Packagist

[](#installation-via-packagist)

Une fois le package publié :

```
composer require uccello/plugin-resource-transfer
```

### Publication de la configuration

[](#publication-de-la-configuration)

Publiez le fichier de configuration :

```
php artisan vendor:publish --tag="plugin-resource-transfer-config"
```

### Configuration du theme.css

[](#configuration-du-themecss)

Pour que les styles du package soient correctement appliqués, ajoutez la directive `@source` dans votre fichier `resources/css/theme.css` pour pointer vers le répertoire de vues du package :

```
@source '../../../../vendor/uccello/plugin-resource-transfer/resources/views';
```

Configuration
-------------

[](#configuration)

### 1. Configurer les ressources exportables

[](#1-configurer-les-ressources-exportables)

Dans le fichier `config/plugin-resource-transfer.php`, déclarez les fichiers associés à chaque ressource que vous souhaitez exporter.

#### Structure de configuration

[](#structure-de-configuration)

Le fichier de configuration supporte deux structures :

**Nouvelle structure (recommandée)** avec support des commentaires et packages :

```
return [
    'UserResource' => [
        'files' => [
            'app/Filament/Resources/UserResource.php',
            'app/Filament/Resources/UserResource',
            'app/Models/User.php',
        ],
        'comment' => "1. Exécuter la migration : php artisan migrate, 2. Publier les assets si nécessaire : php artisan filament:assets, 3. Vérifier les permissions dans le modèle User",
        'packages' => [
            'composer' => ['spatie/laravel-permission:^6.0'],
            'npm' => ['lodash', 'axios@^1.0'],
        ],
    ],
    'ProductResource' => [
        'files' => [
            'app/Filament/Resources/ProductResource.php',
            'app/Filament/Resources/ProductResource',
            'app/Models/Product.php',
            'database/migrations/create_products_table.php',
        ],
        'comment' => "1. Exécuter la migration : php artisan migrate, 2. Configurer les relations dans les modèles associés, 3. Ajouter les permissions dans votre système d'authentification",
        'packages' => [
            'composer' => ['barryvdh/laravel-debugbar'],
            'npm' => ['@heroicons/react'],
        ],
    ],
];
```

**Ancienne structure** (toujours supportée pour compatibilité) :

```
return [
    'UserResource' => [
        'app/Filament/Resources/UserResource.php',
        'app/Filament/Resources/UserResource',
        'app/Models/User.php',
    ],
];
```

#### Explication des champs

[](#explication-des-champs)

- **`files`** (requis) : Tableau des chemins de fichiers relatifs à la racine du projet à inclure dans l'export. Vous pouvez spécifier des fichiers individuels ou des répertoires entiers.
- **`comment`** (optionnel) : Instructions de configuration à suivre après l'importation de la ressource. Ces instructions seront affichées à l'utilisateur après l'importation réussie.
- **`packages`** (optionnel) : Dépendances Composer et npm requises par la ressource. Les packages seront proposés à l'installation après l'importation de la ressource.

    - **`composer`** : Tableau des packages Composer à installer (format: `vendor/package` ou `vendor/package:version`)
    - **`npm`** : Tableau des packages npm à installer (format: `package-name` ou `package-name@version`)

    Exemple :

    ```
    'packages' => [
        'composer' => ['spatie/laravel-permission:^6.0', 'intervention/image'],
        'npm' => ['lodash', 'axios@^1.0', '@heroicons/react'],
    ],
    ```

#### Notes importantes

[](#notes-importantes)

- Les commentaires sont automatiquement inclus dans le manifest lors de l'export et affichés après l'importation.
- Les packages sont automatiquement inclus dans le manifest lors de l'export et proposés à l'installation après l'importation.
- Si vous n'avez pas besoin d'instructions de configuration, vous pouvez omettre la clé `comment`.
- Si vous n'avez pas besoin de packages, vous pouvez omettre la clé `packages` ou ne spécifier que les types nécessaires (par exemple, seulement `composer` ou seulement `npm`).
- Les chemins de fichiers peuvent être relatifs à `base_path()` ou utiliser des chemins absolus.
- Pour les packages Composer, vous pouvez spécifier une version avec la syntaxe Composer standard (ex: `vendor/package:^1.0`, `vendor/package:2.*`).
- Pour les packages npm, vous pouvez spécifier une version avec la syntaxe npm standard (ex: `package@^1.0`, `package@latest`).

### 2. Configurer le panneau avec une classe de plugin

[](#2-configurer-le-panneau-avec-une-classe-de-plugin)

Dans votre `AdminPanelProvider` (ou autre panel provider), ajoutez le plugin au panel :

```
use Uccello\PluginResourceTransfer\PluginResourceTransferPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...existing code...
        ->plugins([PluginResourceTransferPlugin::make()]);
}
```

**Note :** Le plugin enregistre automatiquement la page `ManageResourcesPage` qui est un assistant complet avec sélection du mode (export/import). La page apparaît dans le menu "Mode Développeur" et est automatiquement quand le mode debug est false.

Utilisation
-----------

[](#utilisation)

### Exporter des ressources

[](#exporter-des-ressources)

1. Accédez à la page **Gérer Resources** ou **Export Filament** dans votre panel Filament
2. Sélectionnez les ressources à exporter
3. Prévisualisez les fichiers qui seront inclus
4. Confirmez l'export pour télécharger un fichier ZIP bundle

Le ZIP contiendra tous les fichiers de chaque ressource sélectionnée avec un fichier `manifest.php` décrivant la structure.

### Importer des ressources

[](#importer-des-ressources)

1. Accédez à la page **Gérer Resources** ou **Import Filament** dans votre panel Filament
2. Uploadez le fichier ZIP exporté
3. Les fichiers seront automatiquement copiés aux bons emplacements dans votre projet
4. Le fichier de configuration sera mis à jour automatiquement avec la structure `files` + `comment` + `packages`
5. **Consultez les instructions de configuration** affichées après l'importation pour chaque ressource
6. **Ajoutez les packages requis** (si définis) :
    - Si des packages Composer ou npm sont requis, une section "Packages requis" s'affichera pour chaque ressource
    - Cliquez sur le bouton **"Ajouter aux fichiers JSON"** pour ajouter automatiquement les packages dans `composer.json` et `package.json`
    - Les packages seront ajoutés dans les fichiers JSON sans les installer immédiatement
7. **Installez les packages** :
    - Executer npm install et composer install une fois les packages sont copiés
8. Suivez les étapes indiquées dans les commentaires (migrations, permissions, etc.)
9. Actualisez votre page pour voir les nouvelles ressources dans Filament

**Notes importantes sur l'installation des packages :**

- Les packages sont d'abord ajoutés dans `composer.json` et `package.json` pour garantir la traçabilité
- Les packages existants ne sont pas dupliqués lors de l'ajout
- Si des commentaires de configuration ont été définis lors de l'export, ils seront automatiquement affichés après l'importation pour vous guider dans la configuration de chaque ressource

Credits
-------

[](#credits)

- [Eliot](https://github.com/m4hery)

License
-------

[](#license)

The MIT License (MIT).

###  Health Score

21

—

LowBetter than 21% of packages

Maintenance58

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/0dd3449bee600c805043068270d8c8d1fe7db9960f76e94b660d1192dfd3b3be?d=identicon)[sardoj](/maintainers/sardoj)

---

Top Contributors

[![m4hery](https://avatars.githubusercontent.com/u/140640846?v=4)](https://github.com/m4hery "m4hery (9 commits)")

### Embed Badge

![Health badge](/badges/uccello-plugin-resource-transfer/health.svg)

```
[![Health](https://phpackages.com/badges/uccello-plugin-resource-transfer/health.svg)](https://phpackages.com/packages/uccello-plugin-resource-transfer)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
