= How to Subscribe to CAP Alerts =

[[TOC]]

== Overview ==

The section is intended for Public and Closed User Group (CUG) to subscribe to alerts adopting the various dissemination modes provided.
* Public can subscribe to only public alerts that are offered through RSS/Atom and Social Media feeds
* CUGs (e.g First Responders) can subscribe to Public alerts and other modes such as through SMS, Email, FTP.

The relevant work flows (or actions) for subscribing to SAMBRO alerts:
1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Subscribe#RSSAtomFeeds How to subscribe to RSS/Atom feeds]
1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Subscribe#SocialMediaFeeds How to subscribe to Twitter and Facebook alert pages]
1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Subscribe#SubscribeViaEmailSMSandFTP How to subscribe to receive alerts throughSMS, Email, or FTP]
== Work Flow ==

=== RSS/Atom Feeds ===

||= '''QUICK METHOD''' :: =||=Navigate to http://YOUR-DOMAIN//eden/cap/alert.rss if you have login account else http://YOUR-DOMAIN//eden/cap/public.rss into your RSS/Atom feed reader =||
[[br]]
'''Public''' - messages with <cap:alert><scope>Public</scope></cap:alert>
[[br]]
1. With your web browser, navigate to the SAMBRO website hosted by your National or Local NDMO (e.g. SAMBRO demo hosted at http://sambro.geoinfo.ait.ac.th/)
1. Locate the RSS/Atom icon (based on your installation look and fee). By default SAMBRO has the icon at the top left corner under the Home navigation button
1. Click on the RSS/Atom feed button, which will navigate you to a page that allows you to subscribe the feed through the presented RSS/Atom feed applications and service providers
1. Goto your RSS/Atom feeder and refresh to view the aalerts to test; if you see the feeds you are done.

'''Authenticated User''' - messages with <cap:alert:scope/>Restricted/Private
[[br]]
1. With your web browser, navigate to the SAMRBO website, hosted by you National or Local NDMO, and Login into the application (e.g. SAMBRO demo hosted at http://sambro.geoinfo.ait.ac.th/)
1. Locate the RSS/Atom icon (based on your installation look and fee). By default SAMBRO has the icon at the top left corner under the Home navigation button
1. Click on the RSS/Atom feed button, which will navigate you to a page that allows you to subscribe the feed through the presented RSS/Atom feed applications and service providers
1. You are required to add the same login details in your RSS/Atom reader to receive Restricted and Private alerts
1. Goto your RSS/Atom feeder and refresh to view the alerts to test; if you see the feeds you are done.
=== Social Media Feeds ===
||='''QUICK METHOD''' :: =||=add the National or Local social media feed to your own (Twitter, Facebook, ...) account =||
[[br]]
Contact your National or Local Alerting Authority, such as the National Disaster Management Organization (NDMO) in your country, to identify the Facebook page (e.g. https://www.facebook.com/SahanaSoftwareFoundation/), Twitter name (e.g. [https://twitter.com/SahanaFOSS @SahanaFOSS]). It is very likely that the NDMO would have published this information in their website.
=== Subscribe Via Email, SMS, FTP and GCM ===
These modes are specific to '''Authorized Users only'''!
[[br]][[br]]
||='''QUICK METHOD''' :: =||=Navigate to http://YOUR-DOMAIN/eden/default/index/subscriptions and add/edit the required information =||
[[br]]
[[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/UserGuidelines/SAMBRO/sambro_subscribe_settings.png, align=right)]]
1. With your web browser, navigate to the SAMBRO website hosted by your National or Local NDMO (e.g. SAMBRO demo hosted at http://sambro.geoinfo.ait.ac.th/)
1. To add a new subscription or edit an existing subscription, login to the application and click on the menu with your login name (e.g. myname@example.com) and select '''Subscription Settings''' sub menu
1. To add you communication modes such as email and telephone number, click on the '''Details''' sub menu
1. To add a new subscription - select a combination of event type, warning priority, location, language and alerting frequency, then click ADD TO LIST.
     a. example : event type = "Volcano", warning priority = "High (alert level 5)", location = "My District", language = "English" and alerting frequency = "Weekly"
     a. example : event type = "Accident", warning priority = "Medium (alert level 3)", location = "National", language = "Arabic" and alerting frequency = "Immediately"

[[Image(http://i.imgur.com/efUxdwz.png, align=right)]]
You can choose to subscribe CAP alerts specific to particular event type, priority, particular locations, or any language. [[br]] Click on '''''More Options''''' and you can now choose to subscribe if any new data is inserted or any record is updated, the frequency (Daily, Hourly, Immediately, Never, Weekly) you want to receive the updates through Email or SMS or both (FTP to come) [[br]] Here (in the image to the right, I have subscribed to receive the '''High''' priority alerts for the '''Flood''' in '''Nepal''' which are in '''English''' language. I want those alerts '''Immediately''' after either '''New Records''' are inserted or any '''Record Updates''' via both '''Email''' and '''SMS'''

==== Adding and Editing Contact Details ====

|| 4. || To edit/enter your contact details(Email, SMS, others), if you move your mouse to the menu bar in the place where it displays your email address, you can see sub-menus as dropdown. Move your mouse and click on '''''Contact Details''''' || [[Image(http://i.imgur.com/RJjSfkq.png)]] ||
|| 5. || Now you can edit the existing contact details by opening it using '''''Open''''' Button or add contact details (Mobile Phone, Linkedin, Facebook, etc.) using '''''Add Contact Information''''' button. || [[Image(http://i.imgur.com/3kD64nw.png)]] ||

=== View published alerts ===

After you are logged in as Closed User Group (CUG) meaning Subscribers or Higher, you can view all the alerts (not only scope=public alerts). You can see three frames(boxes) in the main homepage. The left is the CAP Alerts frame. Because you are logged in, you can see all the alerts (log out and see that you can only view the scope=public alerts).[[BR]][[BR]]

Right is the the CAP Aggregator. They come from Twitter Feed/ RSS feed like:
 - http://www.emergencyalert.alberta.ca/aeapublic/feed.atom
 - http://wcatwc.arh.noaa.gov/events/xml/PAAQAtom.xml
 - http://ptwc.weather.gov/feeds/ptwc_rss_pacific.xml
 - http://ptwc.weather.gov/feeds/ptwc_rss_hawaii.xml

[[BR]][[BR]]The middle frame/ map frame shows the <polygon> (location) part of the CAP Alert. These are color coded. You can hover over the polygon or click on the polygon to get further information.[[BR]][[BR]]
[[Image(http://i.imgur.com/kT2NSSk.png)]]
[[BR]][[BR]]Furthermore in the left frame, you can see the '''''Filter Options''''' to filter the alerts according to '''''Priority''''', '''''Event Type''''', '''''Scope''''' and '''''Date'''''.[[BR]][[BR]]Click on the '''''Full Alert''''' or the headline to view the profile page of the individual alerts.

[[Image(http://i.imgur.com/Sja9F7n.png)]]

[[br]]

=== Filter Alerts ===

After logging in, you can filter alerts based on Expiry Date, Source of Origin, Event Type, Scope, Priority, etc. and their combinations.

The default alert list at /cap/alert is the unexpired alerts originating from the system. You can click on '''''More Options''''' to find more filters. [[br]][[br]]

[[Image(http://i.imgur.com/tmnJZQq.png)]] [[br]][[br]]
[[Image(http://i.imgur.com/RuPqGjX.png)]]


== Test the Subscription ==
1. Step 1
1. Step 2


Refer to the design principals