This plugin uses the Twitter API to automatically tweet public links published on Shaarli.

Everytime a new link is shaared, use the "Tweet" checkbox in the form to post it on Twitter. You can edit every tweet format manually if needed.

Note: private links and link edits can't be tweeted.

• PHP 7.1+
• PHP cURL extension
• PHP mbstring extension
• Shaarli >= v0.8.1 (checkout the release page for compatibility)

Download the latest release, and put the folder shaarli2twitter under your plugins/ directory.

Then you can enable the plugin in the plugin administration page http://shaarli.tld/?do=pluginadmin.

Note: the foldername must be shaarli2twitter to work.

Example in command lines:

wget <release URL>.tar.gz
tar xfz <archive>.tar.gz
mv <archive>/shaarli2twitter /path/to/shaarli/plugins

For this plugin to work, you need to register your Shaarli as a Twitter application in your account, and retrieve 4 keys used to authenticate API calls.

You must set this keys in the plugin administration page

While authenticated to your Twitter account, reach this page: https://apps.twitter.com/app/

And Create a new app: name/description are not important, but you may need to put a valid website. Leave "Callback URL" blank.

In your freshly new app page, go to the tab called "Keys and Access Tokens".

Then click on "Create my access token" at the bottom.

You now have everything required to set up shaarli2twitter plugin.

This setting shows the format of tweets. You can use placeholders which will be filled until the 280 chars limit is reached. Values may be truncated if the limit is reached.

Available placeholders, in order of priority:

• ${url}: Shaare URL (will be automatically replaced as t.co links).
• ${permalink}: Shaare permalink (will be automatically replaced as t.co links).
• ${title}: Shaare title.
• ${tags}: List of shaare tags displayed as hashtags (#tag1 #tag2...).
• ${description}: Shaare description.

Default format: #Shaarli: ${title} ${url} ${tags}

Which will render, for example as:

#Shaarli: Wikipedia, the free encyclopedia https://en.wikipedia.org/wiki/Main_Page #crowdsourcing #knowledge

Hide ${url} and/or ${permalink} when sharing a note to long to hold in a tweet.

Values: yes to hide URL or no to keep them. Default value is no.

MIT License, see LICENSE.md.