OpenMRS Feed
OpenMRS provides an aggregate feed of a variety of OpenMRS-related syndicated content on the internet. You can see a filtered view of the feed at feed.openmrs.org. If you have a feed reader that can read rss or atom feeds, you can point it to http://feed.openmrs.org/rss or http://feed.openmrs.org/atom, respectively, for syndicated content about OpenMRS.
The OpenMRS Feed URL
The syntax for the OpenMRS feed is as follows:
http://feed.openmrs.org/[rss|atom]?[tag=x[&tag=x2]][¬ag=y[¬ag=y2][&n=?][&days=?]
- n=?
- Set n to a whole number and the feed will contain no more than this number of posts — e.g. http://feed.openmrs.org/rss?n=5 will return the last five posts.
- days=?
- Defines the number of days back to look. The default is 30 days. Should be a whole number — e.g., http://feed.openmrs.org/rss?days=7 will return posts for the past week.
- tag=x
- Only posts tagged with x will be included in the feed. You can repeat this parameter (e.g., ?tag=x1&tag=x2&tag=x3) to create a feed with posts tagged with either x1, x2, or x3.
- notag=y
- Posts tagged with y will be excluded from the feed. You can repeat this parameter (e.g., ?notag=y1¬ag=y2¬ag=y3) to create a feed with posts tagged with y1, y2, or y3 excluded.
The tag and notag parameters can be combined to create feeds with precisely the content you are interested in. For tags with spaces, replace the space with "%20" (excluding quotes) — e.g., http://feed.openmrs.org/rss?tag=My%20Tag to get posts labeled with "My Tag".
OpenMRS Feed Standard Tags
| Tag | Description |
|---|---|
| announce-list | Posts to the OpenMRS Announcement mailing list |
| blog | Blog posts by the OpenMRS community |
| changeset | Any changes or additions to the OpenMRS code base (includes OpenMRS, modules, and contributions in our repository) |
| dev | All changes (tickets, changesets, and wiki) made within our developer site — i.e., our issue tracker. |
| developer | Posts directed to OpenMRS Developers — e.g., posts to the developers' mailing list or developer-specific blogs. |
| dev-list | Posts to the OpenMRS Developers' mailing list |
| forum | Posts to the OpenMRS Forum |
| implementer | Posts directed to OpenMRS Implementers — e.g., posts to the implementers' mailing list or implementer-specific blogs. |
| implementer-list | Posts to the OpenMRS Implementers' mailing list |
| intern | Posts from OpenMRS interns |
| list | Posts to any OpenMRS-related mailing list |
| mentor | Posts from OpenMRS mentors |
| news | Posts containing OpenMRS-related news |
| milestone | Any changes or additions to the OpenMRS milestones defined in our issue tracker |
| openmrs | OpenMRS-related content. This allows us to aggregate blog posts from community members that may not be specifically related to OpenMRS. |
| soc | Posts related to the Summer of Code work |
| ticket | Any changes or additions to OpenMRS tickets (bugs, enhancements, etc.) entered into our issue tracker |
| wiki | Any changes or additions to the OpenMRS wiki |
These only represent the standard tags that we add to our feeds. They can be helpful in creating a feed that contains only the content of interest for you (or excluding particular content). Any tags/categories added by people posting to blogs will also be added to the post, so you may find that there are other useful tags emerging at feed.openmrs.org.
Examples*
- Only blog entries and news items
- http://feed.openmrs.org/rss?tag=blog&tag=news
- Remove wiki edits and entries within Trac (changesets and tickets)
- http://feed.openmrs.org/rss?notag=wiki¬ag=trac
- Full feed, with all content for the past 7 days
- http://feed.openmrs.org/rss?days=7
*"/atom?" can be substituted for "/rss?" in these links to receive an atom feed instead of rss
FAQ
- How do I get my blog added to the OpenMRS feed?
- Just contact either Burke or Paul (at openmrs.org) and let us know you want to be added. We will need to know three things: (1) who you are, (2) the URL of your RSS or Atom feed, and (3) whether your posts will always be related to OpenMRS. For OpenMRS-specific blogs, we can add the "openmrs" tag to your posts within the OpenMRS feed automatically. If you want to use your blog for non-OpenMRS posts, then we ask that you tag OpenMRS-related material with "openmrs" for the community.
- How often is the OpenMRS Feed updated? Or why is my post not showing up yet?
- We update our feed every 30 minutes. Specific feed requests are cached for at least 15 minutes to reduce the load on our server, so it may take up to an hour before new posts show up in the OpenMRS feed.
