Workflows, Processes, Components & IA

• See also ArchitectureOptions and the SolutionDesign.
• Note, to avoid confusions around text and language, I've used the Drupal convention of t('text'), which means the English word 'text' translated into appropriate [language] for a user's [country]. e.g. t('Search') would be 'Rechercher' in French.

Workflows: TN.org (D6)

Note that 'Normal' initiative viewers and all regular visitors will see no changes.

'National Hub' page viewer (D6)

1. Will see a 'National' page at ​http://www.transitionnetwork.org/world/[localised_country_name] (e.g. in native language like /france, /deutschland, /brasil, but not /germany, /brazil etc).
2. Page will consist of standard D6/English TN.org site structure, menus and blocks, but content area will be the language appropriate for the country.
3. The top part of the content area will consist of some translated welcome/info text. The lower part of the page will hold the "Full page widget" section of "Listings IIRS Widget (D7)", below.
4. Details of the widget part of the page are below.

Workflows: Widgets (D7)

"Full page listings" widget

1. URL TBC but similar to ​http://www.transitionnetwork.org/[langcode]/[localised_country_name]/widget/initiatives/display/full -- though this not be shown to the user usually except when getting the widget code.
2. The widget will have the following display tabs:
   1. t('Latest') - shows users to see the latest [country] initiatives listed,.
   2. t('Map') - shows all the [country] initiatives on a map.
   3. t('Search') - allows searching of initiatives within [country] by criteria.
3. An t('Add your initiative') button opening the Add widget popup -- for details of this, see next section.
4. An t('Initiative details') page appears within the widget in the widget theme (ie with the tabs) whenever an initiative link is clicked within the widget area. This shows the full D7 node view in [language] for the initiative selected. This also allows users to log in and edit the ini if they have an account with the permissions.

"Button-only" widget

1. Like sidebar but with only the t('Add your initiative') button which opens the "Add" widget display, below.

"Add" widget popup display (D7)

1. User clicks button to t('Add your initiative'), popup opens showing URL TBC but similar to ​http://www.transitionnetwork.org/[langcode]/[localised_country_name]/widget/user/login
2. User logs in or registers: NB: to be included at 11/12: registration includes social media option for authentication
3. User enters initiative details. (URL TBC but similar to ​http://www.transitionnetwork.org/[langcode]/[localised_country_name]/widget/initiatives/add
4. User gets thanks page. URL TBC but similar to ​http://www.transitionnetwork.org/[langcode]/[localised_country_name]/widget/initiatives/add/ok
5. User also receives standard email with link to their TI submission with minimal text (needs to be translate-able by National Hub Administrator)

"View Detail" widget display (D7)

1. Any link to an initiative within the Listings widgets shows the detail in [language] showing the full node view of the initiative. URL TBC but likely ​http://www.transitionnetwork.org/[langcode]/[localised_country_name]/widget/initiative/view/[nid]
2. There will be an option to t('Log in to make changes if the user is the owner'), or register and submit their own initiative.
3. If the user is logged in, the t('Edit') tab will be available to users who have permission (editors, admins and the content author).
4. The page will be fully translated into [language].

Workflows: Administering the D7 site, widget and information management

For a National Hub Administrator there are four main parts to setting up and using the IIR Service

1. Installing the National Hub installation which provides the service (online with URLs) and the widgetiser
2. Translating the relevant content
3. Configuring the widget using the widgetiser
4. Administering the submissions via the widget and the standalone online service

1. Installing the National Hub installation using the Aegir system

1. Jim is going to fill this in here
2. Jim is going to fill this in here
3. Jim is going to fill this in here
4. Jim is going to fill this in here

2. Translating the relevant content

ED QUESTION: is this where the NHA does the translation? He thinks so, so he's adding the translation pieces here:

1. NHA needs to be able to
   1. know what they need to translate
   2. site options
   3. email confirmations
   4. about and thank you text
   5. other?
   6. have a simple process to translate these pieces
      • Ed is not sure what this is for now

3. Configuring the widget using the widgetiser

The National Hub administrator will be able to set up a widget and then add/edit/unpublish any Initiative item in their own country. They will be able to see the 'edit' function for all these initiatives as happens on TN.org now.

Useful details from ​PSE workflow?

1. Go to widgetiser build page
2. Choose widget type
3. Add 'view pane path'
4. Add modal popup path'
5. Add modal button text
6. Preview widget
7. Copy widget code
8. Embed into full page of National Hub website

4. Administering TI submissions

1. user submits a TI via the widget. They may have set up a new account (will have for the alpha). The submission is POST-moderated - i.e. it goes into the system as PUBLISHED
2. Each TI submission triggers an email alert to the NHA including URL to user account and TI profile
3. NHA can see the user account and TI profiles without logging into their service site
4. NHA can log into their service site - when logged in, the NHA can:
5. See a list of all the TI submissions in a view showing TI name, URL, PPOC link, status ((not)published)
6. Edit the TI node to make it
   1. UNPUBLISHED
   2. PUBLISHED
7. Edit the user account node to make it
   1. ACTIVE
   2. BLOCKED
   3. DELETED

Information Architecture

User

Mandatory

Standard Drupal user account fields:

1. t('Email') = (built into Drupal)
2. t('Username') = (built into Drupal) --> will be generated from first/middle/last name fields (below) in format "First MM Last" (where M is a single middle name initial). Numbers will be appended if the resultant name is registered in site already.
3. t('Password') = (built into Drupal)

Additional fields:

1. t('First name') = field_user_name_first
2. t('Middle names') = field_user_name_middle
3. t('Last name') = field_user_name_last
4. t('Language') = Provided by core Locale module... This will need to be set automatically by the widget context, and as a fall back should be ​displayed on the registration form)
5. t('Country') OR t'('Address') A custom field, again should be filled from widget context.

Hidden metadata

• UUID = The Universally Unique ID of the user -- system generated, globally shared.
• Uid = The local Drupal user ID -- system generated and not shared outside current site.
• Status = Drupal default 'active/blocked' flag. Allows users to be hidden rather than deleted.

Initiative

• NOTE This content type does not include the old 'Status' field (Muller vs Official) as discussions around this and statuses are ongoing.

Mandatory

1. t('Initiative name')
2. t('Initiative location')

Optional but recommended

1. t('Initiative website')

Available in CT but not in widget (yet)

1. t('Summary') - 255 character simple, punchy 'about this ini' text field
2. t('Further details') - Free text HTML/WYSIWYG field to hold anything else needed: ED 11/12/13: we will not do this for now

Hidden metadata

• Language = Normally shown by Drupa, this will be hidden automatically based on the context of the widget.
• UUID = The Universally Unique ID of the initiative -- system generated, globally shared.
• Nid = The local Drupal node ID -- system generated and not shared outside current site.
• Status = Drupal default 'published' flag. Allows initiatives to be hidden rather than deleted.
• Coordinates = the 'Location' (address) field will be geocoded to provide coordinates so the ini can be placed on the map.

Archived stuff we're not doing which was in the page

"Sidebar listings" widget

1. URL TBC but similar to ​http://www.transitionnetwork.org/[langcode]/[localised_country_name]/widget/initiatives/display/sidebar -- though this not be shown to the user usually except when getting the widget code.
2. Simple listings mode only, DECIDED: based on recently posted nation-wide
3. An t('Add your initiative') which opens 'Add Widget' (see below) in popup.