Proper Job provides a block that you can add to a page. In the block edit dialog, you decide who can run the job, what job will be run, and a label to show on the button or link to run the job.
As a site administrator you can keep control of the dashboard and even the mode of pages, while allowing selected users to run selected jobs. From the block edit dialog you can configure availability of on-page job execution to any of:
For users who do not meet these criteria, the block containing the button or link is simply not shown!
A dropdown select lists all installed jobs alphabetically.
A text field to enter a label for the button or link. The label for the button or link will, by default, be the job name if this field is left empty.
The default block template uses the Bootstrap button and alert styles used in the concrete5 dashboard. Alternate block templates are provided for un-styled buttons and for plain text links.
When a button or link to run a job is clicked, the button or link will be replaced with the job result. This prevents multiple execution of jobs. To run a job again, users will need to refresh the page.
As with any other block that provides a context dependant view, you need to be careful about how you use it on pages where caching is enabled. If a block or page cache is filled in a context where a job execution button or link is shown to a user, then the cached page shown to other users, they could have access to job execution where you do not want them to!
Such issues are not usually of concern during development, but may become important if you have reason to use this block on a production site.
If you experience such issues, it is recommended you add a further level of security to control view access to this block through Advanced Permissions.
The expression "Proper Job" comes from English West Country dialect to describe a job well done. After use by a few notable television and radio personalities, the expression has now achieved much wider use.