Adding StoriedMaps to an existing Open Outreach site

StoriedMaps is a new community mapping distribution based on Open Outreach. It is designed for groups whose primary website use case is to create an online community asset map. The distribution was based off the CRD Community Green Map which will give you a good idea of what is included. If you are creating a fresh site, you can download the whole StoriedMaps installation from GitHub, which includes all of Open Outreach as well as the new community mapping functionality. User documentation for StoriedMaps is also available.

But if you already have an Open Outreach site and want to add these new modules, they are fully compatible with the Debut features that comprise Open Outreach. You have a couple of options to choose from.

Add StoriedMaps Modules

  • You can download the module StoriedMaps Core as well as the required new dependencies of Conditional fields, Email and Masonry (7.x-1.x branch). Enable those modules, along with the sub modules StoriedMaps Story and StoriedMaps Icon and Masonry Views. You'll also need to enable Rules and Entity token if they are not yet enabled on your site.
  • You'll have to do some clean up work as some of the StoriedMaps displays use a full content width and so will not work well if you have content in the sidebars (see below).
  • This is a good option if you basically want to keep your site as it is, but add in the story content type and the enhanced functionality for the Location feature.

Update to StoriedMaps

  • You can also update to the StoriedMaps distribution by unpacking the install over your old Open Outreach site (following the same steps you would to update your site, and of course, first taking a complete back up of the your files and database). You will then need to enable the three StoriedMaps modules (you will also be prompted to enable their dependencies). Once you enable StoriedMaps Story, the story migration will run and you will see two sample stories.
  • If you want to import the location terms and related icons, you will need to follow a couple of steps. If you are already using the location feature and have used the sample terms, do not use these steps as you will lose that data.
    • First, enable the Migrate UI module.
    • Navigate to the Migrate page (admin/content/migrate) and click on the Open Outreach link.
    • Check the boxes beside MigrationTermLocationType and MigrationNodeLocation, select the operation Rollback and then click the Execute button to rollback the migrations.
    • Then selecting the same two migrations, select Import and execute. This will give you the new location terms and their icons as well as new sample locations.
    • You can, of course, just choose to import the terms and not the sample locations if you don't want them.
  • Some of the layouts in the StoriedMaps are designed to use the full page width (that is not have any content in the sidebar). In a typical Open Outreach install, the sidebar is used on most pages (depending on which features you have enabled). You will need to update the contexts to move those blocks to another region, for example the footer region or disable those contexts if they are not necessary for you site. You'll need to ensure the Context UI module is enabled and then under Context (admin/structure/context) select the Context (for example social-follow-site) and edit the reaction removing the block from the second sidebar and adding to the footer region.
  • If you want the new StoriedMaps home page, you'll need to manually set it, by navigating to the site information configuration page (admin/config/system/site-information). Replace home with storiedmaps-home as the default home page path.
  • This home page will feature the icons, stories and locations instead of the blog posts and article comprising a usual Open Outreach install. If you want to combine the two, update the Panels page to add in the panes or block you would like to be visible. For example, if you've updated to the new StoriedMaps home page, you can add in the recent blog post and recent article blocks via the Panels interface (admin/structure/pages) editing the the StoriedMaps home page and editing the content to add in new blocks in the regions you choose.
  • With the StoriedMaps features enabled as well, you may have too many menu items in your main menu to fit comfortably and you may wish to disable one (for example the Multimedia tab) to keep the menu on one line. You may also want to rearrange the order they now appear in. Navigate to admin/structure/menu/manage/main-menu to disable or rearrange.