tripal/tripal_chado_views/theme/tripal_chado_views_help.tpl.php

<h3>Views Integration Description:</h3>
<p>Tripal Views provides an interface for integrating <a href="http://drupal.org/project/views">Drupal Views</a>
   with Chado tables, custom tables and materialized views.  This allows site administrators to create custom pages
   and forms for tables in the Chado schema (if Chado was installed by Tripal).  All tables in Chado are integrated
   automatically with Drupal Views but custom tables and materialized views are not.  After creating a new materialized
   view or custom table you can follow the links above to integrate the table with Drupal Views.  The interface allows
   you to specify which fields the table can be joined with other tables and also specify field, sort and filter
   handlers for views.  Different handlers provide different functionality.
</p>

<br>
<h3>Setup Instructions:</h3>
<p>After installation of the Tripal core module.  The following tasks should be performed</p>
<ol>
  <li><b>Set Permissions</b>: To allow access to site administrators for this module, simply
    <?php print l('assign permissions', 'admin/user/permissions') ?> to the appropriate user roles for the
     permission type "manage tripal_views_integration". </li>
</ol>

<br>
<h3>Usage Instructions:</h3>
<p>To use Tripal Views integration follow these steps:</p>
<ol>
   <li><b>Identify or create a materialized view or custom table:</b> Using the <?php print l('Tripal materialized View interface', "admin/tripal/mviews") ?>
     identify the view you would like to integrate or create a new one.  Or, using the <?php print l('Tripal custom table interface', 'admin/tripal/custom_tables')?></li>
   <li><b>Integration a new table</b>: Navigate to the <?php print l('new integration page', "admin/tripal/views/integration/new") ?>
     to integrate the new table.  Provide a user friendly name
     and description to help you remember the purpose for integrating the view.  Next, select the table  you want to integrate
     from the provided select box.  If your table has fields that can join with other Chado tables, you may
     provide those relationships in the provided form.  Finally, if your fields require a special handlers, you
     may select them from the drop downs provided</li>
   <li><b>Alter an existing integration</b>:  If a table is already integrated you can alter its integration configuration by navigating
     to the <?php print l('list of integrated tables', 'admin/tripal/views/integration/list')?>, select the table from the list and alter it accordingly.
     You can create new integration configurations for tables that are already integrated by lowering the priority setting.  The configuration setting
     with the lowest priority will be selected.</li>
   <li><b>Create custom pages/block/search form</b>:  After saving conifguration settings from either step above, you can navigate to the
     Drupal Views interface where you can create a custom page, block or search form.</li>
   <li><b>Review your integrated views</b>:  A page providing a
     <?php print l('list of all integrated views', "admin/tripal/views/integration/list") ?> is provided. You may
     view this page to see all integrated views, but also to remove any unwanted integrations.</li>
</ol>