Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/meemalabs/laravel-meema
🐏 A blazing-fast Laravel adapter for the official Meema API. An API each Laravel developer will feel welcome to.
https://github.com/meemalabs/laravel-meema
api file-manager image-editing laravel media media-management meema php video-converter video-streaming
Last synced: about 1 month ago
JSON representation
🐏 A blazing-fast Laravel adapter for the official Meema API. An API each Laravel developer will feel welcome to.
- Host: GitHub
- URL: https://github.com/meemalabs/laravel-meema
- Owner: meemalabs
- License: mit
- Created: 2020-02-26T05:54:05.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-04-27T08:53:09.000Z (over 2 years ago)
- Last Synced: 2024-06-08T23:33:47.416Z (3 months ago)
- Topics: api, file-manager, image-editing, laravel, media, media-management, meema, php, video-converter, video-streaming
- Language: PHP
- Homepage:
- Size: 51.8 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-blazingly-fast - laravel-meema - 🐏 A blazing-fast Laravel adapter for the official Meema API. An API each Laravel developer will feel welcome to. (PHP)
README
The most simple way to integrate Meema and your Laravel project
Documentation •
PHP Client •
Report a bug •
FAQ •
Discord
## 🐙 Features
- Most simple way to implement a fully-functional media management system & more
- Thin, minimal & fast package to interact with Meema's API
- Supports PHP `^7.*`
## 💡 Usage
First, install Meema Laravel Client via the [composer](https://getcomposer.org/) package manager:
```bash
composer require meema/laravel-meema
```
Next, you may want to publish the config file with:
```bash
php artisan vendor:publish --provider="Meema\LaravelMeema\Providers\MeemaServiceProvider" --tag="config"
```
Now, you can easily interact with your "media items" using the `Media` facade:
```php
use Meema\LaravelMeema\Facades\Media;
Media::create('New media name');
Media::get();
// specific uuids
Media::get('11a283ed-a64e-424a-aefc-6aa98971d529', '1556fcb8-693e-4431-8b16-3b2b7bb8fcc7');
Media::search('media-name');
// this will return a Response instance
$media = Media::find('11a283ed-a64e-424a-aefc-6aa98971d529');
// you may chain other methods that require an id
$media->update('updated-media-name')
$media->delete();
$media->archive();
$media->unarchive();
$media->makePrivate();
$media->makePublic();
$media->duplicate();
// Relationships with other models.
// Continuing with the chaining methods we used earlier.
$media->folders()->get();
$media->folders()->create('New folder name');
$media->folders()->delete('11a283ed-a64e-424a-aefc-6aa98971d529');
$media->tags()->get();
$media->tags()->associate(['name' => 'Tag Name']);
$media->tags()->disassociate(['name' => 'Tag Name']);
```
Using the `Folder` facade:
```php
use Meema\LaravelMeema\Facades\Folder;
Folder::create('New folder name');
Folder::get();
// specific uuids
Folder::get('11a283ed-a64e-424a-aefc-6aa98971d529', '1556fcb8-693e-4431-8b16-3b2b7bb8fcc7');
Folder::search('folder-name');
// this will return a Response instance
$folder = Folder::find('11a283ed-a64e-424a-aefc-6aa98971d529');
// you may chain other methods that require an id
$folder->update('updated-folder-name')
$folder->delete();
$folder->archive();
$folder->unarchive();
$folder->duplicate();
// Relationships with other models.
// Continuing with the chaining methods we used earlier.
$folder->media()->get();
$folder->tags()->get();
$folder->tags()->associate(['tag_id' => 7]);
$folder->tags()->disassociate(['tag_id' => 7]);
```
Using the `Tag` facade:
```php
Tag::get();
// specific uuids
Tag::get(1, 2, 3);
// this will return a Response instance
$tag = Tag::find(1);
// you may chain other methods that require an id
$tag->update('red-500'); // You will have to use tailwind CSS color palettes.
$tag->delete();
$tag->media()->get();
```
Using the `Favorite` facade:
```php
Favorite::create(['name' => 'New Favorite Name', 'icon' => 'favorite-icon']);
Favorite::get();
// specific uuids
Favorite::get('11a283ed-a64e-424a-aefc-6aa98971d529', '1556fcb8-693e-4431-8b16-3b2b7bb8fcc7');
// this will return a Response instance
$favorite = $client->favorites()->find(1);
// you may chain other methods that require an id
$favorite->update(['name' => 'Updated Favorite Name', 'icon' => 'updated-favorite-icon']);
$favorite->delete();
```
## 🧪 Testing
``` bash
./vendor/bin/pest
```
## 📈 Changelog
Please see our [releases](https://github.com/meemalabs/laravel-meema/releases) page for more information on what has changed recently.
## 💪🏼 Contributing
Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.
## 🏝 Community
For help, discussion about best practices, or any other conversation that would benefit from being searchable:
[Laravel Meema on GitHub](https://github.com/meemalabs/laravel-meema/discussions)
For casual chit-chat with others using this package:
[Join the Meema Discord Server](https://discord.meema.io)
## 🚨 Security
Please review [our security policy](https://github.com/meemalabs/laravel-meema/security/policy) on how to report security vulnerabilities.
## 🙏🏼 Credits
- [Chris Breuer](https://github.com/Chris1904)
- [All Contributors](../../contributors)
## 📄 License
The MIT License (MIT). Please see [LICENSE](LICENSE.md) for more information.