From ce086cf9b945d1f7e4cd9c83defa31343b1bca95 Mon Sep 17 00:00:00 2001 From: M Parker Date: Mon, 9 Jun 2014 09:18:24 -0400 Subject: [PATCH] 2091367-27 --- core/modules/taxonomy/taxonomy.module | 44 +++++++++++++++++++---------------- 1 file changed, 24 insertions(+), 20 deletions(-) diff --git a/core/modules/taxonomy/taxonomy.module b/core/modules/taxonomy/taxonomy.module index fde291e..06c1022 100644 --- a/core/modules/taxonomy/taxonomy.module +++ b/core/modules/taxonomy/taxonomy.module @@ -49,28 +49,32 @@ function taxonomy_help($route_name, Request $request) { case 'help.page.taxonomy': $output = ''; $output .= '

' . t('About') . '

'; - $output .= '

' . t('The Taxonomy module allows you to classify the content of your website. To classify content, you define vocabularies that contain related terms, and then assign the vocabularies to content types. For more information, see the online handbook entry for the Taxonomy module.', array('@taxonomy' => 'http://drupal.org/documentation/modules/taxonomy')) . '

'; + $output .= '

' . t('The Taxonomy module allows users who are able to create and edit content to categorize (tag) content. Users who have the Administer vocabularies and terms permission can add vocabularies that contain a set of related terms. The terms in a vocabulary can either be pre-set by an administrator or built gradually as content is added and edited. Terms may be organized hierarchically if desired.') . '

'; + $output .= '

' . t('For more information, see the online handbook entry for the Taxonomy module.', array('!taxonomy' => 'https://drupal.org/documentation/modules/taxonomy/')) . '

'; $output .= '

' . t('Uses') . '

'; $output .= '
'; - $output .= '
' . t('Creating vocabularies') . '
'; - $output .= '
' . t('Users with sufficient permissions can create vocabularies and terms through the Taxonomy page. The page listing the terms provides a drag-and-drop interface for controlling the order of the terms and sub-terms within a vocabulary, in a hierarchical fashion. A controlled vocabulary classifying music by genre with terms and sub-terms could look as follows:', array('@taxo' => url('admin/structure/taxonomy'), '@perm' => url('admin/people/permissions', array('fragment'=>'module-taxonomy')))); - $output .= '
  • ' . t('vocabulary: Music') . '
    • '; - $output .= '
    • ' . t('term: Jazz') . '
      • '; - $output .= '
      • ' . t('sub-term: Swing') . '
        • '; - $output .= '
      • ' . t('sub-term: Fusion') . '
    '; - $output .= '
    • ' . t('term: Rock') . '
      • '; - $output .= '
      • ' . t('sub-term: Country rock') . '
        • '; - $output .= '
      • ' . t('sub-term: Hard rock') . '
'; - $output .= t('You can assign a sub-term to multiple parent terms. For example, fusion can be assigned to both rock and jazz.') . '
'; - $output .= '
' . t('Terms in a free-tagging vocabulary can be built gradually as you create or edit content. This is often done used for blogs or photo management applications.') . '
'; - $output .= '
' . t('Assigning vocabularies to content types') . '
'; - $output .= '
' . t('Before you can use a new vocabulary to classify your content, a new Taxonomy term field must be added to a content type on its manage fields page. When adding a taxonomy field, you choose a widget to use to enter the taxonomy information on the content editing page: a select list, checkboxes, radio buttons, or an auto-complete field (to build a free-tagging vocabulary). After choosing the field type and widget, on the subsequent field settings page you can choose the desired vocabulary, whether one or multiple terms can be chosen from the vocabulary, and other settings. The same vocabulary can be added to multiple content types, by using the "Re-use existing field" section on the manage fields page.', array('@ctedit' => url('admin/structure/types'))) . '
'; - $output .= '
' . t('Classifying content') . '
'; - $output .= '
' . t('After the vocabulary is assigned to the content type, you can start classifying content. The field with terms will appear on the content editing screen when you edit or add new content.', array('@addnode' => url('node/add'))) . '
'; - $output .= '
' . t('Viewing listings and RSS feeds by term') . '
'; - $output .= '
' . t("Each taxonomy term automatically provides a page listing content that has its classification, and a corresponding RSS feed. For example, if the taxonomy term country rock has the ID 123 (you can see this by looking at the URL when hovering on the linked term, which you can click to navigate to the listing page), then you will find this list at the path taxonomy/term/123. The RSS feed will use the path taxonomy/term/123/feed (the RSS icon for this term's listing will automatically display in your browser's address bar when viewing the listing page).") . '
'; - $output .= '
' . t('Extending Taxonomy module') . '
'; - $output .= '
' . t('There are many contributed modules that extend the behavior of the Taxonomy module for both display and organization of terms.', array('@taxcontrib' => 'http://drupal.org/project/modules?filters=tid:71&solrsort=sis_project_release_usage%20desc')); + $output .= '
' . t('Managing vocabularies') . '
'; + $output .= '
' . t('Users who have the Administer vocabularies and terms permission can add and edit vocabularies from the Taxonomy administration page. Vocabularies can be deleted from their Edit vocabulary page. Users with the Taxonomy term: Administer fields permission may add additional fields to terms in that vocabulary through the Field UI.', array('!taxonomy_admin' => \Drupal::url('taxonomy.vocabulary_list'), '!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')))); + $output .= '
' . t('Managing terms') . '
'; + $output .= '
' . t("Users who have the Administer vocabularies and terms permission or the Edit terms permission for a particular vocabulary can add, edit and organize the terms in a vocabulary from the vocabulary's term listing page, which can be accessed by going to the Taxonomy administration page and clicking List terms from the Operations column. Users must have the Administer vocabularies and terms permission or the Delete terms permission to delete terms.", array('!taxonomy_admin' => \Drupal::url('taxonomy.vocabulary_list'))) . '
'; + $output .= '
' . t('Adding term reference fields') . '
'; + $output .= '
'; + $output .= '

' . t("A user with the Administer fields permission for a certain entity type may add a Term Reference field to an entity sub-type through the Field UI's Manage fields page. To allow entity items to be classified with terms from more than one vocabulary, a Term Reference field must be added for each vocabulary. Limiting the Allowed number of values will restrict how many terms an entity item can be classified with.", array('!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '

'; + $output .= '

' . t("A user with the Administer form display permission for a certain entity type can change the way a Term Reference field prompts for terms through the Field UI's Manage form display page. The Taxonomy module provides three widgets:", array('!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '

'; + $output .= '
    '; + $output .= '
  • ' . t('The Autocomplete term widget (tagging) displays a text field in which users can type a comma-separated list of terms. Choosing this widget allows terms in a vocabulary to be built gradually as content for an entity sub-type is added and edited.') . '
    • '; + $output .= '
  • ' . t('The Select list widget displays the terms in a drop-down list or scrolling list box based on the Allowed number of values set for the field.') . '
    • '; + $output .= '
  • ' . t('The Check boxes/radio buttons widget displays the terms as check boxes or radio buttons based on the Allowed number of values set for the field.') . '
    • '; + $output .= '
'; + $output .= '

' . t("A user with the Administer display permission for a certain entity type can change the way a Term Reference field is displayed to visitors using the Field UI's Manage display page. The Taxonomy module provides three formats:", array('!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '

'; + $output .= '
    '; + $output .= '
  • ' . t('The RSS category format displays nothing when the entity item is displayed as HTML; but displays an RSS category instead of a list when the entity item is displayed in an RSS feed.') . '
    • '; + $output .= '
  • ' . t('The Plain text format displays only the name of the term.') . '
    • '; + $output .= '
  • ' . t('The Link format displays the name of the term linked to a page that lists all content items that have been classified with that term.') . '
    • '; + $output .= '
'; + $output .= '
'; + $output .= '
' . t('Classifying entity items') . '
'; + $output .= '
' . t("If a Term Reference field has been set up for an entity type or sub-type, any user with permission to create or edit entity items of that type can categorize them using the Term Reference widgets on the entity item's form.") . '
'; $output .= '
'; return $output; -- 1.9.2