Go to file
2016-01-10 18:14:34 +01:00
actions fixes #343, value column in config table is converted to text now 2016-01-09 00:50:30 +01:00
classes semi-hide notices form profiles we're blocking 2015-11-18 16:38:19 +01:00
css gif-badge on gif-animations 2016-01-10 18:14:34 +01:00
doc Added to manual option to FAQ19 2016-01-01 12:50:09 +01:00
fonts v4. design, img upload, avatar, bg img, etc etc 2014-11-24 13:47:45 +01:00
img hoover cards (almost finished) 2015-09-16 22:41:48 +02:00
js gif-badge on gif-animations 2016-01-10 18:14:34 +01:00
locale fixes #332 2015-12-30 16:00:18 +01:00
LICENSE upload 2013-08-19 15:30:57 +02:00
QvitterPlugin.php find both http and https notices in notice table 2016-01-08 02:21:14 +01:00
README.md disregard protocol for quoted notices 2016-01-07 16:07:15 +01:00
screenshot.jpg v4. design, img upload, avatar, bg img, etc etc 2014-11-24 13:47:45 +01:00
shortener.php updated the github handle 2015-10-17 09:40:58 +02:00

Qvitter

Qvitter is free software: you can redistribute it and / or modify it
under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version three of the License or (at
your option) any later version.

Qvitter is distributed in hope that it will be useful but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILTY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for
more details.

You should have received a copy of the GNU Affero General Public License
along with Qvitter. If not, see http://www.gnu.org/licenses/.

Setup

  1. Install GNU social directly under a domain (Qvitter is not compatible with subdirectory installs) with fancy urls enabled (if your instance has "index.php" in its URLs, Qvitter will not work properly) and HTTPS enabled (it's always best to use HTTPS from the beginning, there will be issues with federation if you choose to enable HTTPS later)

  2. Put all files in local/plugins/Qvitter

  3. Add addPlugin('Qvitter'); to your /config.php file.

  4. It's highly recommended to use the StoreRemoteMedia plugin. It will cache attachments from remote instances locally and make them appear in the streams. Add addPlugin('StoreRemoteMedia'); to your /config.php file. (Only available in newer GNU social)

  5. There are settings in QvitterPlugin.php, but for easy updates, put them in config.php instead. Example:

// Qvitter-settings
$config['site']['qvitter']['enabledbydefault'] = true;
$config['site']['qvitter']['defaultbackgroundcolor'] = '#f4f4f4';
$config['site']['qvitter']['defaultlinkcolor'] = '#0084B4';
$config['site']['qvitter']['timebetweenpolling'] = 5000;
$config['site']['qvitter']['urlshortenerapiurl'] = 'http://qttr.at/yourls-api.php'; // if your site is on HTTPS, use url to shortener.php here
$config['site']['qvitter']['urlshortenersignature'] = 'b6afeec983';
$config['site']['qvitter']['sitebackground'] = 'img/vagnsmossen.jpg';
$config['site']['qvitter']['favicon'] = 'img/favicon.ico?v=4';
$config['site']['qvitter']['sprite'] = Plugin::staticPath('Qvitter', '').'img/sprite.png?v=40';
$config['site']['qvitter']['enablewelcometext'] = true;
// $config['site']['qvitter']['customwelcometext']['sv'] = '<h1>Välkommen till Quitter.se  en federerad<sup>1</sup> mikrobloggsallmänning!</h1><p>Etc etc...</p>';
// $config['site']['qvitter']['customwelcometext']['en'] = '<h1>Welcome to Quitter.se  a federated microblog common!</h1><p>Etc etc...</p>';
$config['site']['qvitter']['blocked_ips'] = array();

// Recommended GNU social settings
$config['thumbnail']['maxsize'] = 3000; // recommended setting to get more high-res image previews
$config['profile']['delete'] = true; // twitter users are used to being able to remove their accounts
$config['profile']['changenick'] = true; // twitter users are used to being able to change their nicknames
$config['public']['localonly'] = true; // only local users in the public timeline (qvitter always has a timeline for the whole known network)
addPlugin('StoreRemoteMedia'); // makes remote images appear in the feed

The settings should be self-explanatory. In doubt, ask in the !qvitter group on quitter.se, or email h@nnesmannerhe.im

  1. For better performance, disable checkschema (instructions in GNU social's config.php), but don't forget to run it when updating plugins (including Qvitter).

  2. To change the logo, edit /img/sprite.png. For easier git-updates, put it in GNU social's locale folder, and edit the sprite path setting above.

Translation

  1. Translation files reside in /locale and /doc folders.

  2. When translating .json files, don't translate the placeholder strings inside curly brackets {}

API

Qvitter uses GNU social's built in "twitter compatible" API. The API was designed to be compatible with Twitter's API v1.0. Some documentation is here: http://skilledtests.com/wiki/Twitter-compatible_API Twitter's API v1.1 documentation is also useful, but may be partly incorrect.

Qvitter extends this API in a few undocumented ways. Check onRouterInitialized() in QvitterPlugin.php for ideas about paths for the API extensions.

Notes

Qvitter is tested with the latest GNU social nightly