Download the PHP package postsimple/filament-postsimple without Composer

PostSimple for Filament

Send content from your Filament admin panel to PostSimple with one click to automatically generate professional social media content powered by AI.

About PostSimple

PostSimple is an AI-powered social media tool that automatically creates and schedules social media posts tailored to your brand's style across all channels. This Filament plugin allows you to seamlessly send content from your Filament resources to PostSimple for instant social media content generation.

Features

• ✅ One-click integration - Send any resource to PostSimple with a single click
• ✅ Easy configuration - Simple API key setup via .env file
• ✅ Automatic detection - Intelligently finds title and URL from your models
• ✅ Works everywhere - Add to any Filament resource (Posts, Pages, Products, etc.)
• ✅ Multi-language support - Includes English and Dutch translations
• ✅ Secure - API key stored in environment variables

Requirements

• PHP 8.1 or higher
• Laravel 10.0 or higher
• Filament 4.x or 5.x
• PostSimple Pro subscription with API access

Note: The PostSimple API is only available with a Pro subscription. Request your API key at [email protected]

Installation

Install the package via Composer:

Publish the config file (optional):

Configuration

1. Register the Plugin

Add the plugin to your Filament panel provider (e.g., app/Providers/Filament/AdminPanelProvider.php):

2. Get Your API Key

1. Ensure you have a PostSimple Pro subscription
2. Send an email to [email protected] with:
   • Your company name
   • Your PostSimple account email
   • Your website URL
3. You'll receive your API key within 1-2 business days

3. Configure the API Key

Add your PostSimple API key to your .env file:

Usage

Adding the Action to Resources

Recommended: Add the action to your EditRecord or ViewRecord pages. This ensures the record context is properly available.

Add to your resource's EditRecord or ViewRecord page:

Alternative: Table Row Action

If you prefer to add the action directly in your resource table, you can use SendToPostSimpleTableAction:

Example: Blog Post Resource

Here's a complete example of adding PostSimple to a blog post resource. Add the action to your EditPost page:

How It Works

1. Click the "Send to PostSimple" button on any record
2. Confirm the action in the modal
3. The plugin sends the title and URL to PostSimple
4. You're automatically redirected to PostSimple to view the generated content

Model Requirements

The plugin works best when your models follow certain conventions, but it's flexible enough to work with any structure.

Automatic Title Detection

The plugin automatically looks for these fields (in order):

1. Custom field (if you specify with ->titleAttribute())
2. title
3. name
4. heading
5. subject
6. Falls back to ModelName #ID

Example:

Automatic URL Detection

The plugin tries to get the URL in this order:

1. Custom closure (if you specify with ->urlUsing())
2. $record->getUrl() method
3. $record->url() method
4. Builds from slug field: /table-name/{slug}
5. Falls back to: /table-name/{id}

Example with getUrl() method:

Example with route helper:

When Customization is Required

You need to customize when:

• Your title field has a non-standard name (not title, name, heading, or subject)
• You need a specific URL format that can't be auto-detected
• You're working with a headless frontend (different domain)

Product example with customization:

Customization

Custom Title Field

If your model uses a different field for the title, you can specify it:

Custom URL

You can provide a custom closure to generate the URL:

Complete Customization Example

Using Both Title and URL Customization

Configuration Options

The plugin publishes a config file with the following options:

Add to your .env file:

Translations

The plugin includes translations for English and Dutch. The language is automatically detected from your Laravel application's locale.

To publish and customize the translations:

This will publish the language files to lang/vendor/filament-postsimple/.

Troubleshooting

"PostSimple API key not configured"

• Add POSTSIMPLE_API_KEY=your_key to your .env file
• Run php artisan config:clear if using config caching

"No title found"

• Ensure your model has a title, name, heading, or subject field
• Or add a custom getter method

"No URL found"

• Add a getUrl() or url() method to your model
• Or ensure your model has a slug field

"Failed to send to PostSimple"

• Check that your API key is correct
• Verify you have an active Pro subscription
• Check your internet connection
• View the error message for more details

Support

For questions or issues:

• Email: [email protected]
• Website: https://postsimple.app
• Support: https://postsimple.app/support

Changelog

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Security

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

Credits

• PostSimple
• All Contributors

License

The MIT License (MIT). Please see License File for more information.