Adds a new action save_by_keyword to the YOURLS API.
This action either updates the long URL of an existing keyword, or creates a new short URL with the supplied keyword.
This plugin is useful when you prefer to determine your own keywords (e.g: user-id-1, user-id-2, user-joe etc) rather than letting YOURLS generating random ones (e.g: a93al, n9sj8, etc) and you need to keep their long URLs always up to date.
With this action, you may save up to three steps: check if an existing keyword already exists, then delete it, and then generating again under the same keyword.
The request parameters are:
username <api_username>
password <api_password>
action: "save_by_keyword"
format: "json"
url: <required: the long URL to shorten>
keyword: <required: the keyword>
title: <optional: the shorten URL title>
TIP: In case you need to allow multiple short URLs for a same long URL, you need to set the parameter YOURLS_UNIQUE_URLS to false.
# config.php
define( 'YOURLS_UNIQUE_URLS', false );- In
/user/plugins, create a new folder namedyourls-api-save-by-keyword - Drop these files in that directory
- Go to the Plugins administration page and activate the plugin
- Have fun