Manage Your Laravel Schedule From A Web Dashboard
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Added whitelist/blacklist filter option; Updated readme (#86) Mar 4, 2018
database fix(migrations) : foreign key order Nov 7, 2018
public [cleanup] Remove test.sketch; ignore .sketch files (#121) Oct 27, 2018
resources feature(laravel5.7) : laravel 5.7 compatibility Sep 6, 2018
routes fix : styleci Sep 2, 2018
src fix(model) : don't concatenate table prefixes recursively Nov 8, 2018
tests Updated dependencies for laravel 5.6 (#79) Feb 28, 2018
.editorconfig wip : add styleci, travis, gitattributes and editorconfig Aug 6, 2017
.gitattributes refactor(import) : refactor import task and others Sep 2, 2018
.gitignore [cleanup] Remove test.sketch; ignore .sketch files (#121) Oct 27, 2018
.styleci.yml Added onOneServer support and updated StyleCI config. (#103) Jul 4, 2018
.travis.yml wip : add styleci, travis, gitattributes and editorconfig Aug 6, 2017
CHANGELOG.md feature(laravel5.7) : laravel 5.7 compatibility Sep 6, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Aug 6, 2017
CONTRIBUTING.md refactor : dependencies, notifications & instant run Aug 27, 2017
LICENSE chore : initial commit Aug 1, 2017
README.md fix(readme): fix image links Sep 6, 2018
composer.json feature(laravel5.7) : laravel 5.7 compatibility Sep 6, 2018
gulpfile.js refactor(import) : refactor import task and others Sep 2, 2018
package.json refactor(import) : refactor import task and others Sep 2, 2018
phpunit.xml refactor(import) : refactor import task and others Sep 2, 2018

README.md

Laravel Totem

Build Status StyleCI License

Introduction

Join the chat at https://gitter.im/laravel-totem/Lobby

Manage your Laravel Schedule from a pretty dashboard. Schedule your Laravel Console Commands to your liking. Enable/Disable scheduled tasks on the fly without going back to your code again.

Documentation

Compatiblity Matrix

Laravel Totem
5.7 4.x
5.6 3.x
5.5 2.x
5.4 1.x

Installing

Totem requires Laravel v5.4 and above, please refer to the above table for compatability. Use composer to install totem to your Laravel project

composer require studio/laravel-totem

Laravel Totem supports auto package discovery for Laravel v5.5+, therefore service provider registration is not required in Laravel v5.5+

Add TotemServiceProvider to the providers array of your Laravel v5.4 application's config/app.php

Studio\Totem\Providers\TotemServiceProvider::class,

Once Laravel Totem is installed & registered,

  • Run the migration
php artisan migrate
  • Publish Totem assets to your public folder using the following command
php artisan totem:assets
Table Prefix

Totems' tables use generic names which may conflict with existing tables in a project. To alleviate this the .env param TOTEM_TABLE_PREFIX can be set which will apply a prefix to all of Totems tables and their models.

Updating

Please republish totem assets after updating totem to a new version

php artisan totem:assets

Configuration

Cron Job

This package assumes that you have a good understanding of Laravel's Task Scheduling and Laravel Console Commands. Before any of this works please make sure you have a cron running as follows:

* * * * * php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1
Web Dashboard

Laravel Totem's dashboard is inspired by Laravel Horizon. Just like Horizon you can configure authentication to Totem's dashboard. Add the following to the boot method of your AppServiceProvider or wherever you might seem fit.

use Studio\Totem\Totem;

Totem::auth(function($request) {
    // return true / false . For e.g.
    return Auth::check();
});

By default Totem's dashboard only works in local environment. To view the dashboard point your browser to /totem of your app. For e.g. laravel.dev/totem.

Filter Commands Dropdown

By default Totem outputs all Artisan commands on the Create/Edit tasks. To make this dropdown more concise there is a filter config feature that can be set in the totem.php config file.

Example filters

'artisan' => [
    'command_filter' => [
        'stats:*',
        'email:daily-reports'
    ],
],

This feature uses fnmatch syntax to filter displayed commands. stats:* will match all Artisan commands that start with stats: while email:daily-reports will only match the command named email:daily-reports.

This filter can be used as either a whitelist or a blacklist. By default it acts as a whitelist but an option flag can be set to instead act as a blacklist.

'artisan' => [
    'command_filter' => [
        'stats:*',
        'email:daily-reports'
    ],
    'whitelist' => true,
],

If the value of whitelist is false then the filter acts as a blacklist.

'whitelist' => false

Middleware

Laravel Totem uses the default web and api middleware but if customization is required the middleware can be changed by setting the appropriate .env value. These values can be found in config/totem.php.

Making Commands available in Laravel Totem

All artisan commands can be scheduled. If you want to hide a command from Totem make sure you have the hidden attribute set to true in your command. For e.g.

protected $hidden = true;

From L5.5 onwards all commands are auto registered, so this wouldn't be a problem.

Command Parameters

If your command requires arguments or options please use the optional command parameters field. You can provide parameters to your command as a string in the following manner

name=john.doe --greetings='Welcome to the new world'

In the example above, name is an argument while greetings is an option

Console Command

In addition to the dashboard, Totem provides an artisan command to view a list of scheduled task.

php artisan schedule:list

Screenshots

Task List

Task List

Task Details

Task List

Edit Task

Task List

Artisan Command to view scheduled tasks

Task List

Changelog

Important versions listed below. Refer to the Changelog for a full history of the project.

Credits

Bug reports, feature requests, and pull requests can be submitted by following our Contribution Guide.

Contributing & Protocols

License

This software is released under the MIT License.

© 2017 Roshan Gautam, All rights reserved.