heise / shariff
PHP backend for Shariff. Shariff enables website users to share their favorite content without compromising their privacy.
Installs: 139 438
Dependents: 10
Suggesters: 0
Security: 0
Stars: 133
Watchers: 34
Forks: 44
Open Issues: 5
Requires
- php: ^7.4 || ^8.0 <8.2
- guzzlehttp/guzzle: ^7.4.1
- laminas/laminas-cache: ^3.1
- laminas/laminas-cache-storage-adapter-filesystem: ^2.0
- laminas/laminas-cache-storage-adapter-memory: ^2.0
- laminas/laminas-cache-storage-deprecated-factory: ^1.0
- psr/log: ^1.0
Requires (Dev)
- phpunit/phpunit: ^9.5
- dev-master
- v10.0.0
- 9.0.2
- 9.0.1
- 9.0.0
- 8.2.2
- 8.2.1
- 8.2.0
- 8.1.2
- 8.1.1
- 8.1.0
- 8.0.0
- 7.1.4
- 7.1.3
- 7.1.2
- 7.1.1
- 7.1.0
- 7.0.2
- 7.0.1
- 7.0.0
- 6.0.1
- 6.0.0
- 5.2.4
- 5.2.3
- 5.2.2
- 5.2.1
- 5.2.0
- 5.1.0
- 5.0.0
- 4.1.0
- 4.0.2
- 4.0.1
- 4.0.0
- 3.0.1
- 3.0.0
- 2.0.0
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.1
- 1.4.0
- 1.3.0
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.2
- 1.0.0
- dev-feat/captainhook
- dev-docker
This package is auto-updated.
Last update: 2024-10-18 17:58:00 UTC
README
Shariff is used to determine how often a page is shared in social media, but without generating requests from the displaying page to the social sites.
This document describes the PHP backend of Shariff.
Supported services
- Buffer
- StumbleUpon
- Vk
Requirements
To run Shariff PHP Backend on your server you need one of these PHP versions:
- 7.4
- 8.0
- 8.1
- 8.2
Older versions and HHVM are not supported.
Installing the Shariff backend on your own server
To run Shariff under a certain URL, unzip the release zip file into a directory under the document root of your web server.
Take a look into the demo application in the index.php
file and adjust the configuration as necessary.
The following configuration options are available:
Cache settings:
By default Shariff uses the Filesystem cache. By specifying a different adapter from Laminas\Cache\Storage\Adapter you can tell Shariff to use another cache. Also you can specify options for that cache adapter
These option apply for the default Cache class (LaminasCache
) only. If you implement custom caching, you can specify your own options.
Client options
The backend uses Guzzle as HTTP client. Guzzle has many options that you can set, e.g. timeout and connect_timeout. See http://docs.guzzlephp.org/en/latest/request-options.html for a detailed list. In order to set those options pass them in the json with the key "client".
Service Settings
To pass config options to a service, you can add them to the json as well under the name of the service. Currently only the Facebook service has options for an facebook application id and client secret in order to use the graph api id method to get the current share count.
Facebook service options
To use the graph api id method to fetch the share count you need to set up an application at facebook.com and pass in the application id and client secret to the options. It seems that the id method returns the most current share count, but it can be only used with an registered application.
Full config example
use Heise\Shariff\LaminasCache; /** * Sample configuration * * @var array */ private static $configuration = [ 'cacheClass' => 'Heise\\Shariff\\LaminasCache', 'cache' => [ 'ttl' => 60, 'cacheDir' => '/tmp/shariff/cache', 'adapter' => 'Filesystem', 'adapterOptions' => [ // ... ] ], 'client' => [ 'timeout' => 4.2, 'headers' => [ 'User-Agent' => 'shariff/1.0', ] // ... (see "Client options") ], 'domains' => [ 'www.heise.de', 'www.ct.de' ], 'services' => [ 'Facebook', 'Reddit', 'StumbleUpon', 'Pinterest', 'Xing', 'Buffer', 'Vk' ], 'Facebook' => [ 'app_id' => '1234567890', 'secret' => 'terces' ] ];
Testing your installation
If the backend runs under http://example.com/my-shariff-backend/
, calling the URL http://example.com/my-shariff-backend/?url=http%3A%2F%2Fwww.example.com
should return a JSON structure with numbers in it, e.g.:
{"facebook":1452,"reddit":7,"stumbleupon":4325,"pinterest":3,"buffer":29,"vk":326}
Shariff OO interface
If you need more control, you can invoke Shariff in your own PHP code. The following snippet should get you started. $options
are identical to those described above.
use Heise\Shariff\Backend; $options = [ "domains" => ["www.heise.de", "www.ct.de"], "cache" => ["ttl" => 1], "services" => ["Facebook", "Reddit", "StumbleUpon", "Pinterest", "Buffer", "Vk"] ]; $shariff = new Backend($options); $counts = $shariff->get("https://www.heise.de/"); echo $counts["facebook"];