{"id":1272,"date":"2009-06-25T22:15:12","date_gmt":"2009-06-25T20:15:12","guid":{"rendered":"http:\/\/planetozh.com\/blog\/?page_id=1272"},"modified":"2014-08-21T14:44:33","modified_gmt":"2014-08-21T12:44:33","slug":"yourls-wordpress-to-twitter-a-short-url-plugin","status":"publish","type":"page","link":"https:\/\/planetozh.com\/blog\/my-projects\/yourls-wordpress-to-twitter-a-short-url-plugin\/","title":{"rendered":"YOURLS WordPress (a Short URL Plugin)"},"content":{"rendered":"

\"yourls-logo\"YOURLS<\/a> (Y<\/strong>our O<\/strong>wn URL<\/strong> S<\/strong>hortener) is a URL shortener, like TinyURL, except it's all GPL and you can run it on your own server, publicly or for your own use only. It was made by Lester Chan<\/a> and myself. Learn more about YOURLS<\/a>.<\/p>\n

This plugin, YOURLS: WordPress to Twitter<\/strong>, is the bridge between YOURLS and your blog: when you publish a post or a page, it will use your own YOURLS install<\/strong>, either hosted on the same webserver, or another server, to create a short URL for your post.<\/p>\n

The latest version of the plugin does not support Twitter any longer<\/strong>. I have not enough free time to maintain that part, due to the regular changes from Twitter on their authentication process. If you want to auto tweet your posts, use a plugin for that<\/a>.\n<\/div>\n
This plugin is not maintained any longer<\/strong>. It's still working probably fine (here on this blog for instance) but I'm not investing any more time on it. No support or anything.\n<\/div>\n

Download<\/h2>\n
\nDownload the plugin : yourls-wordpress-to-twitter.zip<\/a>
\nExtract and upload to your blog, preserving directory structure.
\nEnjoy.<\/div>\n

Note<\/strong>: the plugin requires PHP 5 to run.<\/p>\n

Template Tags for you theme<\/h2>\n

The plugin comes with two template tags<\/a>:<\/p>\n

wp_ozh_yourls_url()<\/tt><\/b>
\nWill echo a HTML link with short URL (will generate it on the fly if needed) for the current post.
\nExample output:
\n<a href=\"http:\/\/ozh.in\/j5\" rel=\"nofollow alternate shorter\" title=\"short URL\">http:\/\/ozh.in\/j5<\/a><\/tt>
\nSuggested use: in the loop, in single.php, in page.php<\/p>\n

wp_ozh_yourls_head_linkrel()<\/tt><\/b>
\nWill output a <link\/> in <head> for the current post (see revcanonical.appspot.com<\/a> and shorturl.appjet.net<\/a> for more info)
\nExample output:
\n<link rel=\"alternate short shorter shorturl\" href=\"http:\/\/ozh.in\/j5\" \/>\\n<\/tt>
\nNote that WordPress echoes this <link> out of the box so you mostly won't need this one.<\/p>\n

You can also use two other functions in your code and plugins:<\/p>\n

wp_ozh_yourls_raw_url()<\/tt><\/b>
\nWill return (or echo if you pass true<\/tt> to it) the short URL, with no HTML tag or anything else. Just the raw URL.<\/p>\n

wp_ozh_yourls_geturl( $id )<\/tt><\/b>
\nWill return (and generate on the fly if necessary) the short URL for post with id $id<\/p>\n

Easy custom keyword<\/h2>\n

If you want your post to have a custom short URL instead of the random\/sequential generated one, when you write a new post add a new custom field to it (button: "Add Custom Field") with name "yourls-keyword<\/b><\/tt>" and your custom keyword as a value.<\/p>\n

Filters all over the place<\/h2>\n

If you're a coder and want to interact with the plugin, there are a lot of filters for you to do so. Just read the source and look for what you need (and if you cannot find what you need because you'd like another filter somewhere else, please tell me!)<\/p>\n","protected":false},"excerpt":{"rendered":"

YOURLS (Your Own URL Shortener) is a URL shortener, like TinyURL, except it's all GPL and you can run it on your own server, publicly or for your own use only. It was made by Lester Chan and myself. Learn more about YOURLS. This plugin, YOURLS: WordPress to Twitter, is the bridge between YOURLS and […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":241,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1272","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/pages\/1272","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/comments?post=1272"}],"version-history":[{"count":7,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/pages\/1272\/revisions"}],"predecessor-version":[{"id":3289,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/pages\/1272\/revisions\/3289"}],"up":[{"embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/pages\/241"}],"wp:attachment":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/media?parent=1272"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}