Cross Site Publishing and Receiving Information
Introduction
The Cross Site Publishing and Receiving API and GUI (Referred to as `CSPR` from here on) allows plugins to accomplish the following:
- Publish and receive any type of data among not only Geeklog sites but any application (web or desktop) that support the ATOM protocol and implement the REQUEST commands.
Using the CSPR is extremely easy, and all work can usually be done in a few API calls.
Overview, Groups, Feeds, Data
The CSPR contains three main components - repositories, groups and feeds.
- Repositories are a collection of groups, most likely a Geeklog site (or could be another application).
- Groups are collections of feeds, usually about a standard topic (eg. News, Alerts, etc).
- Feeds hold data, and are derived from the group, eg. a `Main Geeklog News Feed` and a `VVT News Feed` for the group News.
Groups and Feeds can either be private or public. Public groups and feeds allow anyone to subscribe to them. Private on the other hand forces subscribers to be approved for access to various feeds. Anyone is able to subscribe to a repository, however depending on the type (Public or Private) a different thing happens. Each subscription is based on the actual repository - a public subscription means that only public groups and feeds are able to be joined, while a private subscription allows both public and private feeds to which the subscription is allowed.