Download

OpenPublish 2.0 -> 2.1 Update Instructions

  1. Make full backup of your 2.0 installation!
  2. Download openpublish 2.1 tar.gz
  3. Save customized portions of your 2.0 installation, in a convenient place, most importantly: settings.php and probably your theme (unless you created your theme as a subtheme of openpublish_theme, which is the recommended approach).
  4. Unpack openpublish 2.1 tar.gz on top of the existing 2.0 installation. Make sure the unpack process overwrote corresponding parts of 2.0 and did not just create a subfolder in 2.0.
  5. Manually delete the folder sites/all/modules/context/context_contrib.
  6. Manually delete all the files under the folder: sites/all/modules/openpublish_core/contexts
  7. Restore the settings.php from the 2.0 installation, since unpack may have overridden it.
  8. You may start seeing error messages. They are ok. Update process is not completed and things are broken until all steps complete.
  9. Enable Following Modules (please do in the exact sequence they are listed below and one module at a time. This is a long and tedious process, so using "drush enable" command is highly recommended. Using drush can also avoid running into errors of half-way updated installation):

    Modules to enable:

    • jquery_update
    • ie_css_optimizer
    • filefield_sources
    • op_contexts (This one is a Feature module, so you can also enable it from the features list).
    • openpublish_menu
  10. Run: http://yourdomain.com/admin/content/clearcache
  11. Run update, via http://yourdomain.com/update.php (Please don't use Drush for this step, it did not work in our tests). You may see some minor warnings. They are ok, you are making significant changes and some minor things may get broken, temporarily.
  12. Run: http://yourdomain.com/admin/content/clearcache
  13. Go to admin/build/features and if you see any features showing "overriden" status, go into the feature, check overriden components and click on "revert components". Repeat for all other overridden features, until all of them show status: "default".

Last, but not least: update customized themes:

1. To use the new two-level menu, replace the following code snippet in page-header.tpl.php:

1
2
3
4
5
6
  <?php if (isset($primary_links)) : ?>
    <?php print theme('links', $primary_links, array('class' => 'links primary-links')) ?>
  <?php endif; ?>
  <?php if (isset($secondary_links)) : ?>
    <?php print theme('links', $secondary_links, array('class' => 'links secondary-links')) ?>
  <?php endif; ?>

with:
1
2
3
    <?php if (isset($expanded_primary_links)): ?>
      <?php print theme('openpublish_menu', $expanded_primary_links); ?>
    <?php endif; ?>      

2. Instructions for how to integrate RDFa in your existing themes, can be found in the OpenPublish Theming Guide