Overview
This page describes the plugin specification for the integration of status.net microblogging platform into Community Equity.
The status.net activity streams plugin will support th activity streams standard 1.0 activity streams AND CEQ specific extensions.
|
Table of contents
Unique URL mapping
| URL | Remark |
|---|---|
| http://xx.xx/notice/5185338 | using unique notice ID |
User ID mapping
| this table is used to map the UserID from your web venue to the CeQ User Key |
Laconica should be integrated with OpenSSO. Then we would not need any userID mapping
| CeQ | status.net |
Activity Streams |
CeQ Extension |
Remark |
|---|---|---|---|---|
| PersonKey | display name http://activitystrea.ms/schema/1.0/person |
display name http://activitystrea.ms/schema/1.0/person |
||
| ScreenName | display name http://activitystrea.ms/schema/1.0/person |
display name http://activitystrea.ms/schema/1.0/person |
||
| Surname |
|
|||
| GivenName |
|
|||
| Email |
<email:"address"> |
|||
| PictureURL |
avatar http://activitystrea.ms/schema/1.0/person |
PhotoURL |
||
| Country |
<country:"country"> | Country of the user's Primary address |
if integrated with OpenSSO - getting all attributes from Master authentication service - means no need to map UserID
Asset type mapping
| this table is used to map the asset type from your web venue to the CeQ application type |
| Asset Type | CeQ Application | Laconi.ca |
Activity streams object | Remark |
|---|---|---|---|---|
| Microblogging |
Microblogging |
Notice |
http://activitystrea.ms/schema/1.0/note | see http://martin.atkins.me.uk/specs/activitystreams/activityschema#anchor8 for details |
| Attachment |
Attachment |
Attachment to a notice |
http://activitystrea.ms/schema/1.0/file | are attachments just images or general attachments . If its just images we should use http://activitystrea.ms/schema/1.0/photo or |
Activity mapping
| this table is used to map the activities between status.net and CeQ. |
| CeQ Activity | Activity Streams Verb |
Micro Blogging | status.net |
|---|---|---|---|
| CREATE: Indicates that an information has been created | Post http://activitystrea.ms/schema/1.0/post Documentation |
. | onEndNoticeSave |
| DELETE: Indicates that an information has been deleted | Delete http://community-equity.org/schema/1.0/delete * add additional post verb to support default activity streams reader |
onEndNoticeDelete | |
| CLONE: Indicates that an information has been cloned | Clone http://community-equity.org/schema/1.0/clone * add additional post verb to support default activity streams reader |
ReTweet by whom | onEndNoticeSave, RT @username message |
| RATE: Indicates that an information has been rated | Favorite http://activitystrea.ms/schema/1.0/favorite Unfavorite http://community-equity.org/schema/1.0/unfavorite * add additional post verb to support default activity streams reader Suggest to use favorite and do the mapping in the CEQ backend e.g. favorite = 4star, unfavorite= 3star? |
How many times it's been favored - if favored - map to 5 star? by whom? [http://community-equity.org/schema/1.0/rate]
|
onFavorNotice / onDisfavorNotice |
| COMMENT: Indicates that an information has been commented | Post http://activitystrea.ms/schema/1.0/post Documentation |
How many responses there are to it.? by whom? | onEndNoticeSave, checks if the comment_to field has a value |
| UPDATE_META_DATA: Indicates that the meta data of an information has been updated | N/A | N/A |
N/A |
| TAG: Indicates that an information has been tagged | Tag http://activitystrea.ms/schema/1.0/tag Documentation |
#tags and !tags | onEndNoticeSave, check all tags and groups used and send it over |
| VIEW: Indicates that an information has been viewed | Play http://activitystrea.ms/schema/1.0/play Documentation |
||
| Join Group |
Join http://activitystrea.ms/schema/1.0/join Documentation |
||
| Leave Group |
http://community-equity.org/schema/1.0/leave * add additional post verb to support default activity streams reader |
||
| N/A |
start follow http://activitystrea.ms/schema/1.0/follow |
||
| N/A |
http://community-equity.org/schema/1.0/unfollow * add additional post verb to support default activity streams reader |
Access Control mapping
| this section is used to map the Access control information from your web venue to the CeQ ACL service |
Group/Members synchronization
- Define which system is the System of Record (SoR) for the group/membership management
- Define the synchronization model from your SoR with the CeQ group management
Laconica groups are the SoR for Groups. Following events need to be captured
| Event |
status.net |
CeQ |
Activity streams |
Remark |
|---|---|---|---|---|
| Create Group |
http://activitystrea.ms/schema/1.0/group | |||
| Delete Group |
http://activitystrea.ms/schema/1.0/group |
Information ACL mapping
if we have ACL in .8 an beyond we should map read/write access
| InformationID or URL | Read | Write | Admin |
|---|---|---|---|
| https://xxx.com/xxx | group(s),user(s) | group(s),user(s) | group(s),user(s) |
Options
Feed duration
There will be a parameter in the feed URL to define the date/time and page_size of the feed. The default will be 1 day
Example: http://xxx.com/feed/activity.atom?datetime=01/012/2009/12:00&page_size=100
Related Tickets
Related content
|
|
|
|
|
|
|
|
|
|
|
|
|
|