Create custom scripts and manage them directly from the WordPress Dashboard. Schedule scripts, handle user input, download reports, and more.
Why would I ever need to run a script on-demand, rather than on page load?
There are many times running on page load is not the best option:
- You may want to ensure that a task only happens once, when many people may be visiting the page
- You may need to capture some form of output from the script, without showing it to all users
- You may have multiple team members working on the site, and not want to harm their workflow with your debugging output
- You may need to be able to have non-developers run the script periodically, for tasks like report generation
There are too many other use cases to count. If you don’t see a use case, you probably don’t need this tool, and that’s ok.
Why not just write some custom PHP and tuck it in a subfolder?
There are many caveats to taking this approach, but mostly it just leaves you writing a lot of (probably insecure) code.
To build a custom script properly, you need to:
- Handle security on your own.
- Either duplicate or side-load any WordPress functions you need
- Build an interface and form handler
- Handle downloads
- Handle cron
- Get around PHP_MAX_EXECUTION_TIME
That can be a massive amount of code, for a script that could be as simple as a single SQL query.
Why not WP-CLI?
We love WP-CLI, but sometimes the command line is just not the right tool for the job. Often you can’t get WP-CLI on shared hosts, and users who may need to use the utilities may not be comfortable with the command line. But stay tuned, WP-CLI integration is on our roadmap.
Why not (Insert Solution Here)?
The most common answer is feature completion and ease of access. A utility script can contain as little as 17 lines of overhead, before you are free and clear to write whatever you need. We dare you to find a lighter-weight, more feature-complete option. We wrote WP Utility Script Runner because there wasn’t one.
Is it possible to get down to under 17 lines of boilerplate?
Technically? Yes. But you’ll be sacrificing a lot of features. You can write your utility in “legacy mode”, where it can be written as simply as:
<?php
// Utility Name: My Legacy Utility
// Description: An example of a legacy utility
echo “Hello World”; // your custom code goes here
You will not get native handling for inputs, files, state, downloads, or error output, but it is pretty darn short.
Why aren’t there any useful utilities bundled in?
Most of the time, we find that Utility Scripts are very custom to the specific site and hosting environment. We have plans to build a library of useful scripts, but for now, we just included a couple examples to help you get started writing your own.
Your plugin is bad, and You should feel bad!
While that’s not exactly a question, we do take bug reports and reviews very seriously. In addition, you can always contact us directly with your thoughts, at support@burlingtonbytes.com.
