From 07d0f26f9ccdd2499226459b7fe29d39c7d7df41 Mon Sep 17 00:00:00 2001 From: Drew Reece Date: Thu, 7 Apr 2011 17:25:12 +0100 Subject: [PATCH] Issue #1114772: Adding help for Views exports. --- help/ctools.help.ini | 6 +++++ help/export-views-bulk.html | 44 +++++++++++++++++++++++++++++++++++++++++ help/export-views-single.html | 39 ++++++++++++++++++++++++++++++++++++ 3 files changed, 89 insertions(+), 0 deletions(-) create mode 100644 help/export-views-bulk.html create mode 100644 help/export-views-single.html diff --git a/help/ctools.help.ini b/help/ctools.help.ini index fcb121b..1560b76 100644 --- a/help/ctools.help.ini +++ b/help/ctools.help.ini @@ -57,6 +57,12 @@ title = Exportable objects tool [export-ui] title = Exportable objects UI creator +[export-views-single] +title = Export and importing a view + +[export-views-bulk] +title = Export views to a module + [form] title = Form tools diff --git a/help/export-views-bulk.html b/help/export-views-bulk.html new file mode 100644 index 0000000..8450946 --- /dev/null +++ b/help/export-views-bulk.html @@ -0,0 +1,44 @@ +This documentation focuses on the Chaos tools bulk export and version control functionality of the Chaos tools module. The following steps document how to export multiple views at once and create a module from the exported code that will allow you to revert any subsequent changes to your views. + +Assumptions: +- You have views you want to bulk export; we'll call them myView1 and myView2 +- You know how to install and enable a module + + +
    +

  1. Modules you will need

    +

    Install Views and Chaos tools and enable the following modules: Views, Views UI, Chaos tools, Bulk Export

    +
    2. +

  2. Evaluate the current state of views

    +

    Navigate to the Views Administration page. You should have operations for Edit | Disable | Delete | Clone | Export next to myView1 and myView2. Once we're done, "Delete" will become "Revert"!

    +
    3. +

  3. Bulk export your views

    +
      +
    1. Click Structure > Bulk Exporter to navigate to the Bulk Exporter page to export myView1 and myView2.
      2. +
    2. Check the boxes to the left of myView1 and myView2
      3. +
    3. Choose a module name: my_views
      4. +
    4. Click Export
      5. +
    +
    4. +

  4. Create a module from the exported views

    +

    The results of the export should now be in front of you. Specifically, the results page should be composed of three code-containing regions. This code and the following steps are all you need to create a module that will allow you to revert your views to the state they were in when you exported them. +

      +
    1. Create a directory called my_views within your sites/all/modules directory.
      2. +
    2. Create the following files, paste in the appropriate code, and place them into the my_views directory:
      3. +
        +
      • my_views.info
        • +
      • my_views.module (ensure <?php tags are at the beginning of this file!)
        • +
      • my_views.views_default.inc (ensure <?php tags are at the beginning of this file!)
        • +
      +
    +
    5. +

  5. Clear the cache

    +

    Just to be safe. Navigate to the Performance Administration page and Clear cached data.

    +
    6. +

  6. Enable the module containing exported views

    +

    Navigate to the Modules Administration page and enable my_views export module. Save.

    +
    7. +

  7. Verify presence of reversion option for exported views

    +

    Navigate to the Views Administration page. The operations for myView1 and myView2 should now read Edit | Export | Clone | Revert. Congratulations, you now have version control in place for your exported views!

    +
    8. +
diff --git a/help/export-views-single.html b/help/export-views-single.html new file mode 100644 index 0000000..6380194 --- /dev/null +++ b/help/export-views-single.html @@ -0,0 +1,39 @@ +This documentation focuses on the Chaos tools import and export feature. The following steps document how to export a single view, then re-import the view, potentially to a different site. + +Assumptions: +- You have a view you want to export; we'll call it myView +- You know how to install and enable a module + +

Modules you will need

+

Install Views and Chaos tools and enable the following modules: Views, Views UI, Chaos tools, Bulk Export

+ +
    +

    Exporting views

    + +

  1. Export the view

    +

    Navigate to the Views Administration page. You should have operations for Edit | Disable | Delete | Clone | Export next to myView. +

      +
    1. Click Export on the operation for myView.
      2. +
    2. The results of the export should now be in front of you. Specifically, the results page should be composed of one code-containing region. This code and the following steps are all you need to re-create myView to the state it was in when you exported it.
      3. +
    3. Copy the text to a file for safe keeping.
      4. +
    +
    2. +
+ +
    +

    Importing views

    +

  1. Import your view

    +

    Navigate to the Views Administration page and click Import.

    +
      +
    1. Paste in the code from the text file created from the previous export of myView.
      2. +
    2. Click Import.
      3. +
    + +

  2. Clear the cache

    +

    Just to be safe. Navigate to the Performance Administration page and Clear cached data.

    +
    3. + +

  3. Verify the view

    +

    Return to Views Administration page to verify the view has imported. Congratulations, you just imported your exported view!

    +
    4. +
\ No newline at end of file -- 1.7.3.1