https://github.com/jessemaps/yourls-query-string-keeper

Query String Keeper plugin for YOURLS
https://github.com/jessemaps/yourls-query-string-keeper

Last synced: 2 months ago
JSON representation

Query String Keeper plugin for YOURLS

• Host: GitHub
• URL: https://github.com/jessemaps/yourls-query-string-keeper
• Owner: jessemaps
• License: mit
• Created: 2016-11-07T20:56:28.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2016-11-08T19:57:41.000Z (about 8 years ago)
• Last Synced: 2024-08-02T06:16:50.377Z (5 months ago)
• Language: PHP
• Size: 1.95 KB
• Stars: 9
• Watchers: 3
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - Query String Keeper - Pass the query string from the shortlink to the long URL (eg `http://sho.rt/kk?hey` forwards to `http://long.url/bleh/?hey`). (Plugins / Q)

README

        
# Query String Keeper

Query String Keeper plugin for [YOURLS](http://yourls.org) - tested on version 1.7.

Description

-----------

Query String Keeper retains the query string added to the short url and adds it to the long url. If the long URL already includes a query string, it appends it following an ampersand (&) and if not, appends it to the long url following a question mark (?).  

Examples

--------

Examples 1 & 2 use the following short & long URLs configured in YOURLS:  

Short url = `http://sho.rt/keyword`  

Long url  = `http://www.longurl.com`  

_Example 1_  

`http://sho.rt/keyword?foo=bar`  

...becomes...  

`http://www.longurl.com/?foo=bar`  

_Example 2_  

`http://sho.rt/keyword?123`  

...becomes...  

`http://www.longurl.com/?123`  

Example 3 uses the following short & long URLs configured in YOURLS:  

Short url = `http://sho.rt/keyword`  

Long url  = `http://www.longurl.com?foo=bar`  

_Example 3_  

`http://sho.rt/keyword?zoo=car`  

...becomes...  

`http://www.longurl.com/?foo=bar&zoo=car`  

Installation

------------

1. Move query-string-keeper directory to the `/user/plugins` directory of the YOURLS installation.  

2. Go to the Plugins administration page ( *eg* `http://sho.rt/admin/plugins.php` ) and activate the `Query String Keeper` plugin.  

Other/References

----------------

This plugin adapted from the Query String Forward plugin by [llonchj](https://github.com/llonchj/yourls_plugins) which doesn't handle passing a single number as in `sho.rt/foo?123`.  

The Append Query String plugin by [drockney](https://github.com/drockney/append-qs) works for those that want the query string to just be appended without the ? or & symbols.