Download the PHP package bambolee-digital/event-user-manager without Composer

Event User Manager

Português

Event User Manager is a Laravel package for managing user events with support for recurrence, attachments, and integration with Filament for administration.

Installation

You can install the package via composer:

This package depends on spatie/laravel-translatable. If you haven't already installed it, you can do so by running:

Configuration

Publish the configuration file with:

This will create a config/event-user-manager.php file. You can modify the settings as needed.

You will need to register the following resources in your filament configuration file:

Usage

API

The package provides API endpoints for managing events, notes, attachments, and images. The main endpoints are:

Events

• GET /api/events: List events
• POST /api/events: Create a new event
• GET /api/events/{id}: Get event details
• PUT /api/events/{id}: Update an event
• DELETE /api/events/{id}: Delete an event
• GET /api/events/past: Get past events
• GET /api/events/future: Get future events
• GET /api/events/status/{status}: Get events by status

Notes

• POST /api/events/{event}/notes: Add a note to an event
• PUT /api/events/{event}/notes/{note}: Update a note
• DELETE /api/events/{event}/notes/{note}: Delete a note

Attachments and Images

• POST /api/events/{event}/attachments: Add an attachment to an event
• DELETE /api/events/{event}/attachments/{attachment}: Remove an attachment from an event
• POST /api/events/{event}/images: Add an image to an event
• DELETE /api/events/{event}/images/{image}: Remove an image from an event

API Usage Examples

Here are comprehensive examples for using the Event User Manager API. These examples use the Guzzle HTTP client, but you can adapt them to your preferred HTTP client.

Setup

First, set up the HTTP client:

Events

List Events

Create a Comprehensive Event

Get Event Details

Update an Event

Delete an Event

Get Past Events

Get Future Events

Get Events by Status

Notes

Add a Note to an Event

Update a Note

Delete a Note

Attachments

Add an Attachment to an Event

Remove an Attachment from an Event

Images

Add an Image to an Event

Remove an Image from an Event

These examples cover all the main operations available through the Event User Manager API. Remember to replace 'http://your-api-base-url/' with your actual API URL and 'YOUR_API_TOKEN' with a valid authentication token. Also, adjust file paths in the examples to match your local file structure.

This example demonstrates creating an event with:

• Basic event details (name, description, dates, status)
• Event type and recurrence pattern
• Metadata (location and expected attendees)
• Main event attachments and images
• Notes with their own attachments and images

Remember to replace 'http://your-api-base-url/' with your actual API URL and 'YOUR_API_TOKEN' with a valid authentication token.

Filament Admin

The package includes Filament resources for managing events, event types, and recurrence patterns. These will be automatically available in your Filament panel.

Notifications

The package includes a configurable notification system. You can add custom notification channels by editing the configuration file.

Customization

You can extend or override any functionality of the package. Refer to the configuration file for customization options.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Contributions are welcome! Please see CONTRIBUTING for details.

Security

If you discover any security-related issues, please email [email protected] instead of using the issue tracker.

Credits

• Kellvem Barbosa
• All Contributors

License

The Event User Manager is open-sourced software licensed under the MIT license.