Share on FineFriends
Let your users share content from your website to FineFriends easily
With sharing, people can easily bring the content of your website to FineFriends. When people click the Share button, a dialog opens. Sharing can automatically generate a text for the page, or you can customize it the way you want.
Sharing only needs the user to be logged in at FineFriends and is really easy to implement to your project.
Add the button
You can add Sharing to your website in many ways. The way you design it on your end if completely up to you. What we advise, is something like this:
It is recognizable to FineFriends users and helps them to find it, but you are free to design it by yourself.
Share a page
To share a page, you simply open the Sharer. The URL for the share form can be build up with several options.
| Key | Required? | Description |
|---|---|---|
| u | Yes | This is the URL of the page. You can enter it manually or automatically. |
| text | No | By default, FineFriends will use the title of your webpage if available. You can also set a custom text. Users can change the text before posting, this is just the default value. |
| via | No | If you want your FineFriends account to be mentioned on sharing, you can set your account name here. Users can remove or change the tag before posting, this is just the default value. |
The URL will always start with 'https://finefriends.social/api/sharer'. Then, you can add the keys to the URL to customize the sharer.
The basic keys wil give you an URL like this: 'https://finefriends.social/api/sharer?u=https://example.com'. This will try to grab the title from the page and put it in the post, followed by the URL. Everything in this post can be changed by the user.
Apart form the required basic keys, you can also set additional keys. For example, you can change the text to show the introduction of your article instead of the page title using the 'text' key. You can also mention yourself using the 'via' key. An URL with additional keys looks like this: 'https://finefriends.social/api/sharer?u=https://example.com&text=This%20is%20a%20custom%20text&via=FineFriends'. Again, everything you set by these keys can be changed by the user.
You can add the keys to the URL manually, but in most cases, you would need to insert the keys automatically. This can be done in several ways. Here are some examples:
PHP:
<?php $currentURL = (isset($_SERVER['HTTPS']) ? "https" : "http") . "://$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]";?>
<a href="https://finefriends.social/api/share?u=<?phpecho $currentURL?>">
Share on FineFriends
</a>
JavaScript:
<a id="shareFineFriends" href="">
Share on FineFriends
</a>
<script>
$("#shareFineFriends").attr("href", "https://finefriends.social/api/sharer?u="+window.location.href);
</script>
Please note that these are just examples, no warranty is given that these work as expected and we are not responsible for any problems with or caused by the code.