Create your account and start posting your micro-content
We are currently testing the service, you will soon find more documentation there. In the meantime we will happily answer your questions by mail.
A simple API, no SDK required
This basic example presents a Facebook share link to the user, when clicked a request is sent to popo.st and a good old Facebook share popup is opened.
Hiding popo.st to your users
If you don't specify a custom share domain, popo.st will use re.popo.st which will appear within Facebook. Obviously you'd prefer to display your own brand there!
Follow this steps to setup your own share domain:
For instance, if your project's domain name is youbrand.com you may dedicate share.yourbrand.com to sharing.
Go to your DNS provider website (Gandi, Go-daddy, etc.)
In your DNS records, add a CNAME entry which, in its text form, will read like this:
share 3600 IN CNAME re.popo.st.
shareis the subdomain name you chose
3600is the time to live of this entry in DNS caches over the world
CNAMEmeans that share.yourbrand.com is served at the following direction
re.popo.stis the target domain name.
Edit your project on popo.st and set your Share Domain to your fully qualified domain name, in this example: share.yourbrand.com.
This is a limitation of the Facebook scraper. It has to load your image to discover its dimensions which happens in the background and too late. To fix this, simply specify the width and the height of your image when calling Popo.st.
You must open the popup during the onClick/onPress/on* event. Otherwise the browser will refuse to create your popup. When you have your popup, then call popo.st api and finally set the popup's location with the result of the API call.