tripal_views_admin.tpl.php 3.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. <h3>Tripal Views Quick Links:</h3>
  2. <ul>
  3. <li><?php print l('List of integrated tables',"admin/tripal/views/integration/list") ?></li>
  4. <li><?php print l('Integrate a new table',"admin/tripal/views/integration/new") ?></li>
  5. <li><?php print l('Import a previously exported table integration.',"admin/tripal/views/integration/import") ?></li>
  6. </ul>
  7. <br>
  8. <h3>Views Integration Description:</h3>
  9. <p>Tripal Views provides an interface for integrating <a href="http://drupal.org/project/views">Drupal Views</a>
  10. with Chado tables, custom tables and materialized views. This allows site administrators to create custom pages
  11. and forms for tables in the Chado schema (if Chado was installed by Tripal). All tables in Chado are integrated
  12. automatically with Drupal Views but custom tables and materialized views are not. After creating a new materialized
  13. view or custom table you can follow the links above to integrate the table with Drupal Views. The interface allows
  14. you to specify which fields the table can be joined with other tables and also specify field, sort and filter
  15. handlers for views. Different handlers provide different functionality.
  16. </p>
  17. <br>
  18. <h3>Setup Instructions:</h3>
  19. <p>After installation of the Tripal core module. The following tasks should be performed</p>
  20. <ol>
  21. <li><b>Set Permissions</b>: To allow access to site administrators for this module, simply
  22. <?php print l('assign permissions', 'admin/user/permissions') ?> to the appropriate user roles for the
  23. permission type "manage tripal_views_integration". </li>
  24. </ol>
  25. <br>
  26. <h3>Usage Instructions:</h3>
  27. <p>To use Tripal Views integration follow these steps:</p>
  28. <ol>
  29. <li><b>Identify or create a materialized view or custom table:</b> Using the <?php print l('Tripal materialized View interface', "admin/tripal/mviews") ?>
  30. 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>
  31. <li><b>Integration a new table</b>: Navigate to the <?php print l('new integration page', "admin/tripal/views/integration/new") ?>
  32. to integrate the new table. Provide a user friendly name
  33. and description to help you remember the purpose for integrating the view. Next, select the table you want to integrate
  34. from the provided select box. If your table has fields that can join with other Chado tables, you may
  35. provide those relationships in the provided form. Finally, if your fields require a special handlers, you
  36. may select them from the drop downs provided</li>
  37. <li><b>Alter an existing integration</b>: If a table is already integrated you can alter its integration configuration by navigating
  38. to the <?php print l('list of integrated tables', 'admin/tripal/views/integration/list')?>, select the table from the list and alter it accordingly.
  39. You can create new integration configurations for tables that are already integrated by lowering the priority setting. The configuration setting
  40. with the lowest priority will be selected.</li>
  41. <li><b>Create custom pages/block/search form</b>: After saving conifguration settings from either step above, you can navigate to the
  42. Drupal Views interface where you can create a custom page, block or search form.</li>
  43. <li><b>Review your integrated views</b>: A page providing a
  44. <?php print l('list of all integrated views', "admin/tripal/views/integration/list") ?> is provided. You may
  45. view this page to see all integrated views, but also to remove any unwanted integrations.</li>
  46. </ol>