f(x) Updater Plugin

Here’s step by step instruction to configure your plugin updates using f(x) Updater plugin.

1. Add plugin update repository

Navigate to f(x) Updater > Plugins, and click “Add New” to create your plugin update repository. And fill the data as example below:

The plugin folder/file should be unique. Everything else are self-explanatory.

2. Include the updater class in your theme

You can use the updater class included in the f(x) Updater plugin:

https://github.com/turtlepod/fx-updater/blob/master/includes/updater.php

Include it in your plugin. example code:

/* Include plugin updater. */
require_once( trailingslashit( plugin_dir_path( __FILE__ ) ) . 'includes/updater.php' );

and configure the config array as needed:

$this->config = array(
    'server'  => 'http://your-website/',
    'type'    => 'plugin',
    'id'      => 'plugin-folder/plugin-file.php',
    'api'     => '1.0.0', // leave it as is
    'post'    => array(), // leave it as is
);

server
This is your website home url where you install f(x) Updater. This is the server where the plugin will pull the update data.

type
Updater type, change the value to “plugin” for single plugin updater, “theme” for single theme updater, and “group” for multi item updates (within the group). In this case we use it for plugin updates.

id
This is the item id. add it with plugin id (plugin folder/file). as you have configured in f(x) Updater (in step 1)

api
Current f(x) updater api version. currently leave it as “1.0.0”. This is to make it easier for future development, in case we change method in the future.

post
Data you add here will send via $_POST to your server when checking for updates. useful if you want to extend this plugin and use update restriction/license key, etc

3. That’s it !

1. Install your plugin (with the updater.php included and configured) in other sites/client sites.
2. If you add new features to your plugin/fix a bug. Create version 2 (new version).
3. Update your f(x) Updater Plugin repository entry (step 1): change the version number with new version. change the ZIP URL to this new version. Add changelog if needed.
4. Don’t forget to save/update.
5. Visit/log-in your other/client site where you install the plugin.
6. Navigate to “Dashboard > Updates” to check new updates.
7. Update your plugin.