You may use Composer to install Mixpost into your new Laravel project:
composer require inovector/mixpostAfter installing the Mixpost package, you may execute:
php artisan mixpost:installMixpost uses Job Batching and you should create a database migration to build a table to contain meta information about your job batches.
If your application does not yet have this table, it may be generated using the:
php artisan queue:batches-tableRun the migrations with:
php artisan migrateYou can publish the config file with:
php artisan vendor:publish --tag=mixpost-configThis is the contents of the published config file:
return [
/*
* Mixpost will redirect unauthorized users to the route name specified here
*/
'redirect_unauthorized_users_to_route' => 'login',
/*
* The disk on which to store added files.
* Choose one or more of the disks you've configured in config/filesystems.php.
*/
'disk' => env('MIXPOST_DISK', 'public'),
/*
* Indicate that the uploaded file should be no more than the given number of kilobytes.
* Adding a larger file will result in an exception.
*/
'max_file_size' => [
'image' => 1024 * 5, // 5MB
'gif' => 1024 * 15, // 15MB
'video' => 1024 * 200 // 200MB
],
/*
* Accepted mime types for media library upload.
* These are all supported mime types for the image and video files. We do not guarantee that it will work with other types.
* If you need to remove certain mime types, you are free to do so from here.
*/
'mime_types' => [
'image/jpg',
'image/jpeg',
'image/gif',
'image/png',
'video/mp4'
],
/*
* The path where to store temporary files while performing image conversions.
* If set to null, storage_path('mixpost-media/temp') will be used.
*/
'temporary_directory_path' => null,
/*
* FFMPEG & FFProbe binaries paths, only used if you try to generate video thumbnails
*/
'ffmpeg_path' => env('FFMPEG_PATH', '/usr/bin/ffmpeg'),
'ffprobe_path' => env('FFPROBE_PATH', '/usr/bin/ffprobe'),
/*
* Define cache prefix
*/
'cache_prefix' => env('MIXPOST_CACHE_PREFIX', 'mixpost'),
/*
* Define log channel
* Captures connection errors with social networks or third parties used in Mixpost in a separate channel.
* Leave blank if you want to use Laravel's default log channel
*/
'log_channel' => env('MIXPOST_LOG_CHANNEL'),
/*
* The media component is integrated with third-party services Unsplash.com and Tenor.com
* Defines the default terms for displaying media resources
*/
'external_media_terms' => ['young', 'social', 'mix', 'content', 'viral', 'trend', 'test', 'light', 'true', 'false', 'marketing', 'self-hosted', 'ambient', 'writer', 'technology'],
/*
* Options for each social network
* We recommend leaving these options unchanged
* You only change them when the API policy of the social networks changes, and you know what you are doing.
*/
'social_provider_options' => [
'twitter' => [
'simultaneous_posting_on_multiple_accounts' => false,
'post_character_limit' => 280,
'media_limit' => [
'photos' => 4,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
],
'facebook_page' => [
'simultaneous_posting_on_multiple_accounts' => true,
'post_character_limit' => 5000,
'media_limit' => [
'photos' => 10,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
],
'facebook_group' => [
'simultaneous_posting_on_multiple_accounts' => true,
'post_character_limit' => 5000,
'media_limit' => [
'photos' => 10,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
],
'mastodon' => [
'simultaneous_posting_on_multiple_accounts' => true,
'post_character_limit' => 500,
'media_limit' => [
'photos' => 4,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
]
],
];Mixpost has the ability to generate images from video while uploading a video file. This would not be possible without FFmpeg installed on your server. You need to follow FFmpeg installation instructions on their official website.
After installation, depending on the operating system, you need to set the ffmpeg_path and ffprobe_path in the
Mixpost config file.
Default folder path: /usr/bin/. If FFmpeg is there, there is no need to change it.
/*
* FFMPEG & FFProbe binaries paths, only used if you try to generate video thumbnails
*/
'ffmpeg_path' => env('FFMPEG_PATH', '/usr/bin/ffmpeg'),
'ffprobe_path' => env('FFPROBE_PATH', '/usr/bin/ffprobe'),Mixpost handles various tasks in a queued way via Laravel Horizon. If your application doesn't have Horizon installed yet, follow their installation instructions.
After Horizon is installed, don't forget to set QUEUE_CONNECTION in your .env file to redis.
config/horizon.php should have been created in your project. In this config file, you must add a block
named mixpost-heavy to both the production and local environment.
'environments' => [
'production' => [
'supervisor-1' => [
'maxProcesses' => 10,
'balanceMaxShift' => 1,
'balanceCooldown' => 3,
],
'mixpost-heavy' => [
'connection' => 'mixpost-redis',
'queue' => ['publish-post'],
'balance' => 'auto',
'processes' => 3,
'tries' => 1,
'timeout' => 60 * 60,
],
],
'local' => [
'supervisor-1' => [
'maxProcesses' => 3,
],
'mixpost-heavy' => [
'connection' => 'mixpost-redis',
'queue' => ['publish-post'],
'balance' => 'auto',
'processes' => 3,
'tries' => 1,
'timeout' => 60 * 60,
],
],
],In the config/queue.php file you must add the mixpost-redis connection:
'connections' => [
// ...
'mixpost-redis' => [
'driver' => 'redis',
'connection' => 'default',
'queue' => env('REDIS_QUEUE', 'default'),
'retry_after' => 11 * 60,
'block_for' => null,
],Don't forget running php artisan horizon. In production, you need a way to keep your horizon processes running. For
this reason, you need to configure a process
monitor Supervisor that can detect when your horizon
processes exit and automatically restart them.
Example of supervisor config:
[program:mixpost_horizon]
process_name=%(program_name)s
command=php /path-to-your-project/artisan horizon
autostart=true
autorestart=true
user=your_user_name
redirect_stderr=true
stdout_logfile=/path-to-your-project/storage/logs/horizon.log
stopwaitsecs=3600In the console kernel (app/Console/Kernel.php), you should schedule this command.
protected function schedule(Schedule $schedule)
{
// ...
$schedule->command('mixpost:run-scheduled-posts')->everyMinute();
$schedule->command('mixpost:import-account-data')->everyTwoHours();
$schedule->command('mixpost:import-account-audience')->everyThreeHours();
$schedule->command('mixpost:process-metrics')->everyThreeHours();
$schedule->command('mixpost:delete-old-data')->daily();
}Don't forget to add a cron that running the scheduler:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
Mixpost does not come with any user management, we assume that you already provide this in your own app. You can use a gate check to determine who can access Mixpost.
However, we have created a separate package Mixpost Auth that you can install very easily. Read the documentation of this package to find out how to install it.
You can determine which users of your application are allowed to view the Mixpost UI by defining a gate check called
viewMixpost in your app/Providers/AppServiceProvider.php file.
public function boot()
{
\Illuminate\Support\Facades\Gate::define('viewMixpost', function ($user = null) {
return optional($user)->email === 'dima@inovector.com';
});
}Mixpost will redirect unauthorized users to the route name specified in the redirect_unauthorized_users_to_route key of the
Mixpost config file.
After performing all these steps, you should be able to visit the Mixpost UI at /mixpost.
composer test