--- C:/Users/zmove/Desktop/taxonomy_list.module Sun May 11 15:40:54 2008
+++ D:/Taf/Kalys/drupal6/sites/all/modules/taxonomy_list/taxonomy_list.module Fri Jun 13 08:28:20 2008
@@ -1,715 +1,718 @@
-'. t('The Taxonomy List module adds pages that list all terms in a vocabulary (category). In addition, when the Taxonomy Image module is installed, these lists can include an image for each term.') .'';
- }
-}
-
-/**
- * Implementation of hook_perm().
- */
-function taxonomy_list_perm() {
- return array('administer taxonomy_list');
-}
-
-/**
- * Implementation of hook_menu().
- */
-function taxonomy_list_menu() {
- $items = array();
-
- $items['admin/settings/taxonomy_list'] = array(
- 'title' => 'Taxonomy List',
- 'description' => 'Customize how Taxonomy List displays terms on vocabulary pages.',
- 'page callback' => 'drupal_get_form',
- 'page arguments' => array('taxonomy_list_admin_settings'),
- 'access arguments' => array('administer site configuration'),
- 'type' => MENU_NORMAL_ITEM,
- );
-
- $items['taxonomy/vocabulary/%'] = array(
- 'page callback' => 'taxonomy_list_show',
- 'page arguments' => array(2),
- 'access arguments' => array('access content'),
- 'type' => MENU_CALLBACK,
- );
-
- return $items;
-}
-
-/**
- * Implementation of hook_init().
- */
-function taxonomy_list_init() {
- drupal_add_css(drupal_get_path('module', 'taxonomy_list') .'/taxonomy_list.css');
-}
-
-/**
- * Implementation of hook_theme().
- */
-function taxonomy_list_theme() {
- return array(
- 'taxonomy_list_admin_links' => array(
- 'arguments' => array('vids'),
- ),
- 'taxonomy_list_vocabulary' => array(
- 'arguments' => array('vocabulary'),
- ),
- 'taxonomy_list_term' => array(
- 'arguments' => array('term', 'vocabulary', 'controls'),
- ),
- );
-}
-
-/**
- * Show the category list
- */
-function taxonomy_list_show($str_vids, $max_depth = 'all', $op = null, $columns = null) {
- if (preg_match('/^([0-9]+[+ ])+[0-9]+$/', $str_vids)) {
- // The '+' character in a query string may be parsed as ' '.
- $vids = preg_split('/[+ ]/', $str_vids);
- }
- else if (preg_match('/^[0-9]+$/', $str_vids) ) {
- $vids = array($str_vids);
- }
-
- if (count($vids) <= 0) {
- drupal_not_found();
- return;
- }
-
- // Do we want to list the nodes?
- if ($op == 'list') {
- return taxonomy_list_nodes_render($vids, $max_depth);
- }
-
- $controls = array(
- 'show_image' => variable_get('taxonomy_list_show_image', 1),
- 'cells_per_row' => $columns ? $columns : variable_get('taxonomy_list_cell_per_row', 2),
- 'count_type' => variable_get('taxonomy_list_count', 'none'),
- 'no_show' => variable_get('taxonomy_list_noshow', false),
- 'edit_link' => $op == 'block' ? false : variable_get('taxonomy_list_edit_link', false),
- 'search_link' => $op == 'block' ? false : variable_get('taxonomy_list_search_link', false),
- 'rss_link' => variable_get('taxonomy_list_rss_link', false),
- 'image_link' => variable_get('taxonomy_list_image_link', 'term'),
- 'destination' => drupal_get_destination(),
- 'taxonomy_image' => module_exists('taxonomy_image'),
- 'list_mode' => variable_get('taxonomy_list_list_mode', 0),
- 'max_depth' => $max_depth == 'all' ? 9999999 : $max_depth,
- 'related' => variable_get('taxonomy_list_related', false),
- 'synonyms' => variable_get('taxonomy_list_synonyms', false),
- 'show_parents' => variable_get('taxonomy_list_show_parents', false),
- );
-
- if ($controls['cells_per_row'] > 0) {
- $controls['cell_width'] = floor(100 / $controls['cells_per_row']);
- }
- else {
- $controls['cell_width'] = 100;
- }
-
- $vocab_titles = array();
- $total_terms = 0;
-
- $output = '';
-
- foreach ($vids as $vid) {
- $vocab = taxonomy_vocabulary_load($vid);
- $vocab_titles[] = $vocab->name;
-
- switch ($controls['list_mode']) {
- case 0:
- // Hierarchical. Only get first level, because _get_table will do children.
- $terms = taxonomy_get_tree($vid, 0, -1, 1);
- break;
-
- case 1:
- // Flat. Get all terms.
- $terms = taxonomy_get_tree($vid, 0, -1, $max_depth);
- break;
- }
-
- $c = count($terms);
- if ($c <= 0) {
- // This vocab has no term, skip.
- continue;
- }
- $total_terms += $c;
-
- $output .= theme('taxonomy_list_vocabulary', $vocab, variable_get('taxonomy_list_types', false), (count($vids) > 1));
-
- $output .= _taxonomy_list_get_table($terms, $vocab, $controls, 1);
- }
- if ($op != 'block') {
- drupal_set_title(implode(variable_get('taxonomy_list_title_separator', ' & '), $vocab_titles));
- }
-
- $output .= '
'; // class="taxonomy-list"
-
- if ($total_terms == 0) {
- drupal_not_found();
- return;
- }
-
- if ($op != 'block') {
- $output .= theme('taxonomy_list_admin_links', $vids);
- }
-
- return $output;
-}
-
-/**
- * Pad the remaining cells in the table
- */
-function _taxonomy_list_pad_row(&$cells, &$rows, $cells_per_row) {
- $cellscount = count($cells);
-
- if ($cellscount > 0) {
- // padding
- for ($j = $cellscount; $j < $cells_per_row; $j++) {
- $cells[] = ' ';
- }
- $rows[] = array('data' => $cells);
- $cells = array();
- }
-}
-/**
- * Generate cascaded tables with terms and sub terms inside
- */
-function _taxonomy_list_get_table($terms, $vocabulary, $controls, $depth) {
- // list of terms those already rendered
- static $done = array();
- $cells = array();
- $rows = array();
-
- foreach ($terms as $term) {
- // Have we already seen this term?
- if (isset($done[$term->tid])) {
- continue;
- }
-
- // Indicate that we've already done this term and save its name.
- $done[$term->tid] = $term->name;
-
- // Taxonomy_get_children does not provide depth or parents.
- if (!isset($term->depth)) {
- $term->depth = $depth;
- }
-
- if ($depth < $controls['max_depth']) {
- $children = taxonomy_get_children($term->tid, $vocabulary->vid);
- }
- else {
- $children = null;
- }
- $has_children = $children && ($controls['list_mode'] == 0);
-
- if ($has_children) {
- // Pad the row so the parent term will start at the begining of the next row.
- _taxonomy_list_pad_row($cells, $rows, $controls['cells_per_row']);
- }
-
- // TODO: consider a depth attribute for parents.
- $cell = $has_children ? '' : null;
-
- $stuff = theme('taxonomy_list_term', $term, $vocabulary, $controls);
- // Was there something in the cell?
- if (!$stuff) {
- continue;
- }
- $cell .= $stuff;
-
- $cell .= '
'; // class="taxonomy-list-item"
-
- if ($has_children) {
- $cell .= '
';
- $cell .= _taxonomy_list_get_table($children, $vocabulary, $controls, $depth + 1);
- $cell .= '
'; // class="taxonomy-list-children"
- $cell .= ''; // class="taxonomy-list-cascade"
- }
-
- if ($has_children) {
- // Span the cell to cover the whole row, and then the
- // next term will start at the begining of the next row
- $cells[] = array('data' => $cell, 'width' => '100%', 'colspan' => $controls['cells_per_row']);
- $rows[] = array('data' => $cells);
- $cells = array();
- }
- else {
- $cells[] = array('data' => $cell, 'width' => $controls['cell_width'] .'%');
-
- // add cell into the row, advance row if it reach the end of row
- if (count($cells) % $controls['cells_per_row'] == 0) {
- $rows[] = array('data' => $cells);
- $cells = array();
- }
- }
- }
-
- // ensure that the table will be in good shape
- // by padding the last row of the table
- _taxonomy_list_pad_row($cells, $rows, $controls['cells_per_row']);
-
- $table_attrs = array(
- 'id' => 'taxonomy-list-table-'. $vocabulary->vid,
- 'class' => 'taxonomy-list-table',
- );
- return theme('table', array(), $rows, $table_attrs);
-}
-
-/**
- * Select and render the nodes in the chosen vocabularies.
- */
-function taxonomy_list_nodes_render($vids, $max_depth) {
- $output = '';
- $terms = array();
- // Get vocabulary names and list of tids.
- foreach ($vids as $vid) {
- $vocab = taxonomy_vocabulary_load($vid);
- $vocab_titles[] = $vocab->name;
- // Taxonomy_select_nodes will do the depth part for us, so we just get the top terms.
- $terms = array_merge($terms, array_map('_taxonomy_get_tid_from_term', taxonomy_get_tree($vid, 0, -1, 1)));
- }
- drupal_set_title(implode(variable_get('taxonomy_list_title_separator', ' & '), $vocab_titles));
- sort($terms);
-
- // Render all nodes in a pager using taxonomy function.
- $output .= taxonomy_render_nodes(taxonomy_select_nodes($terms, 'or', $max_depth));
-
- $output .= '
'; // class="taxonomy-list"
- return $output;
-}
-
-/**
- * Theme the admin links.
- */
-function theme_taxonomy_list_admin_links($vids) {
- $destination = drupal_get_destination();
- $output = '';
- $links = array();
-
- if (user_access('administer taxonomy')) {
- foreach ($vids as $vid) {
- $vocabulary = taxonomy_vocabulary_load($vid);
- $links['taxonomy_list_add_'. $vid] = array(
- 'title' => t('Add to "!name"', array('!name' => $vocabulary->name)),
- 'href' => 'admin/content/taxonomy/'. $vocabulary->vid .'/add/term',
-// 'query' => $destination, // Term adds won't come back.
- );
- $links['taxonomy_list_edit_'. $vid] = array(
- 'title' => t('Edit "!name"', array('!name' => $vocabulary->name)),
- 'href' => 'admin/content/taxonomy/edit/vocabulary/'. $vocabulary->vid,
- 'query' => $destination,
- );
- }
- }
- if (user_access('administer taxonomy_list')) {
- $links['taxonomy_list_admin'] = array(
- 'title' => t('Taxonomy list settings'),
- 'href' => 'admin/settings/taxonomy_list',
- 'query' => $destination,
- );
- }
-
- $output .= theme('links', $links);
- $output .= '
';
- return $output;
-}
-
-/**
- * Theme the vocabulary.
- */
-function theme_taxonomy_list_vocabulary($vocabulary, $types = false, $title = true) {
- $output = '';
- if ($title) {
- $output .= '
'. $vocabulary->name .'
';
- }
- $output .= '
'. $vocabulary->description .'
';
- if ($types) {
-// $list = array_intersect_key(node_get_types('names'), array_flip($vocabulary->nodes)); /* php 5.1 */
- $list = array_flip(array_intersect(array_flip(node_get_types('names')), $vocabulary->nodes));
- $output .= '
'. t('Used for content types') .': '. implode(', ', $list) .'
';
- }
- $output .= '
';
- if ($controls['taxonomy_image'] && $controls['show_image']) {
- $links = array();
- switch ($controls['image_link']) {
- case 'term':
- // Must use the 'html' flag for the l function.
- $links['taxonomy-list-image'] = array(
- 'title' => taxonomy_image_display($term->tid),
- 'href' => taxonomy_term_path($term),
- 'html' => true,
- );
- break;
- case 'big':
- $obj = taxonomy_image_get_object($term->tid);
- $links['taxonomy-list-image'] = array(
- 'title' => taxonomy_image_display($term->tid),
- 'href' => $obj->url,
- 'html' => true,
- );
- }
- $output .= theme('links', $links);
- }
-
- switch ($controls['count_type']) {
- case 'none':
- $counter = null;
- break;
-
- case 'all':
- $count = taxonomy_term_count_nodes($term->tid);
- if ($count == 0 && $controls['no_show']) {
- return null;
- }
- $counter = '
('. $count .')
';
- break;
-
- case 'not_zero':
- case 'by_type':
- $count_list = array();
- $count = 0;
- foreach ($vocabulary->nodes as $type) {
- $this_count = taxonomy_term_count_nodes($term->tid, $type);
- if ($this_count > 0 || $controls['count_type'] == 'by_type') {
- $count_list[] = $type .': '. $this_count;
- }
- $count += $this_count;
- }
- if ($count == 0 && $controls['no_show']) {
- return null;
- }
- if ($count_list) {
- $counter = '
('. implode(', ', $count_list) .')
';
- }
- break;
- }
-
- // Create the term name as a taxonomy/term link with this term's tid as a named anchor (for related links).
- $output .= '
'
- . l($term->name, taxonomy_term_path($term), array('attributes' => array('class' => 'taxonomy-list-term'), 'html' => true));
-
- // Do we want parents?
- if ($controls['show_parents'] && $term->depth > 0) {
- $parent_list = array();
- $parents = taxonomy_get_parents_all($term->tid);
- // Get rid of self;
- unset($parents[0]);
- foreach ($parents as $parent) {
- $parent_list[] = l($parent->name, 'taxonomy/vocabulary/'. $vocabulary->vid, array('fragment' => $parent->tid));
- }
- $output .= '
[« '. implode(' « ', $parent_list) .']
';
- }
-
- // Add the counters.
- $output .= $counter;
-
- $links = array();
- // Do we want edit link?
- if (user_access('administer taxonomy') && $controls['edit_link']) {
- $links['taxonomy-list-edit-link'] = array(
- 'title' => 'edit term',
- 'href' => 'admin/content/taxonomy/edit/term/'. $term->tid,
- 'attributes' => array('title' => t('make changes to this term')),
- 'query' => $controls['destination'],
- );
- }
-
- // Do we want search link?
- if (user_access('search content') && $controls['search_link']) {
- $links['taxonomy-list-search-term'] = array(
- 'title' => t('search for term'),
- 'href' => 'search/node/"'. $term->name .'"',
- 'attributes' => array('title' => t('search for content using this term')),
-// 'query' => $controls['destination'],
- );
- }
-
- // Do we want RSS link?
- if ($controls['rss_link']) {
- $links['taxonomy-list-rss'] = array(
- 'title' => '
 .'misc/feed.png)
',
- 'href' => 'taxonomy/term/'. $term->tid .'/'. $controls['max_depth'] .'/feed',
- 'attributes' => array('title' => t('create feed for this term')),
- 'html' => true,
-// 'query' => $controls['destination'],
- );
- }
-
- if ($links) {
- $output .= theme('links', $links, array('class' => 'links inline'));
- }
-
- $output .= '
'. check_markup($term->description) .'
';
-// $output .= '
'. $term->description .'
';
-// $output .= '
';
- $output .= ''. t('Related terms') .': '. implode(', ', $names);
- $output .= '
';
- }
- }
-
- if ($controls['synonyms']) {
- if ($synonyms = taxonomy_get_synonyms($term->tid)) {
- $output .= '';
- $output .= ''. t('Synonyms') .': '. implode(', ', $synonyms);
- $output .= '
';
- }
- }
-
- $output .= ''; // class="taxonomy-list-item"
- return $output;
-}
-
-/**
- * Implementation of hook_block()
- */
-function taxonomy_list_block($op = 'list', $delta = 0, $edit = array()) {
- global $user;
- switch ($op) {
- case 'list':
- $vocabularies = taxonomy_get_vocabularies();
- foreach ($vocabularies as $vocabulary) {
- $blocks[$vocabulary->vid]['info'] = t('Taxonomy List for @name', array('@name' => $vocabulary->name));
- }
- return $blocks;
-
- case 'view':
- // $delta is the vid.
- $block['content'] = taxonomy_list_show($delta, 'all', 'block', 1);
- return $block;
-
- case 'configure':
- $form = array();
- return $form;
-
- case 'save':
- return;
- } // end switch($op)
-}
-
-/**
- * Menu callback; presents the admin settings form.
- */
-function taxonomy_list_admin_settings() {
- $form = array();
-
- $form['taxonomy_list_info'] = array(
- '#value' => t('The taxonomy_list module enable the URL to browse into each vocabulary, using the format of :
')
- . t('"taxonomy/vocabulary/<vid>"')
- . t('Together with the taxonomy_image.module, the list can be displayed with a image icon.
')
- );
-
-// General settings.
- $form['general'] = array(
- '#type' => 'fieldset',
- '#title' => t('General settings'),
- '#collapsible' => true,
- '#collapsed' => false,
- );
-
- $sep_opts = array(
- ' & ' => 'ampersand (&)',
- ' | ' => 'vertical bar (pipe)',
- ', ' => 'comma (,)',
- ' • ' => 'bullet',
- ' – ' => 'en-dash (–)',
- ' — ' => 'em-dash (—)',
- ' _ ' => 'underscore',
- );
- $form['general']['taxonomy_list_title_separator'] = array(
- '#type' => 'radios',
- '#title' => t('Vocabulary separator'),
- '#default_value' => variable_get('taxonomy_list_title_separator', ' & '),
- '#options' => $sep_opts,
- '#description' => t('This is the character that separates multiple vocabulary names in the page title.'),
- '#prefix' => '',
- '#suffix' => '
',
- );
-
- $form['general']['taxonomy_list_list_mode'] = array(
- '#type' => 'radios',
- '#title' => t('List Mode'),
- '#default_value' => variable_get('taxonomy_list_list_mode', 0),
- '#options' => array(
- '0' => t("Hierarchical - Subcategories as a table inside their parent's cell."),
- '1' => t('Flat - All terms are listed as the same level in the grid.'),
- ),
- '#description' => t('How Taxonomy List displays the list of terms.'),
-// '#prefix' => '',
-// '#suffix' => '
',
- );
-
- $form['general']['taxonomy_list_cell_per_row'] = array(
- '#type' => 'textfield',
- '#title' => t('Terms per row'),
- '#size' => 5,
- '#default_value' => variable_get('taxonomy_list_cell_per_row', 2),
- '#description' => t('Number of terms to be displayed on the same row.'),
- );
-
-// General link settings.
- $form['general']['link'] = array(
- '#type' => 'fieldset',
- '#title' => t('Link options'),
- '#collapsible' => true,
- '#collapsed' => false,
- );
-
- $form['general']['link']['taxonomy_list_edit_link'] = array(
- '#type' => 'checkbox',
- '#title' => t('Add "edit term" link'),
- '#default_value' => variable_get('taxonomy_list_edit_link', false),
- '#description' => t('Should I add an "edit term" link to the display for authorized users?'),
- );
-
- if (module_exists('search')) {
- $form['general']['link']['taxonomy_list_search_link'] = array(
- '#type' => 'checkbox',
- '#title' => t('Add "search for term" link'),
- '#default_value' => variable_get('taxonomy_list_search_link', false),
- '#description' => t('Should I add an "search for term" link to the display for authorized users?'),
- );
- }
-
- $form['general']['link']['taxonomy_list_rss_link'] = array(
- '#type' => 'checkbox',
- '#title' => t('Add RSS link'),
- '#default_value' => variable_get('taxonomy_list_rss_link', false),
- '#description' => t('Should I add an RSS link (icon) to the display?'),
- );
-
-// Optional settings.
- $form['optional'] = array(
- '#type' => 'fieldset',
- '#title' => t('Optional information'),
- '#collapsible' => true,
- '#collapsed' => true,
- );
-
- $form['optional']['taxonomy_list_types'] = array(
- '#type' => 'checkbox',
- '#title' => t('Show content types'),
- '#default_value' => variable_get('taxonomy_list_types', false),
- '#description' => t('Do you want to display a list of the content types for the vocabulary?'),
- );
-
- $form['optional']['taxonomy_list_related'] = array(
- '#type' => 'checkbox',
- '#title' => t('Show related terms'),
- '#default_value' => variable_get('taxonomy_list_related', false),
- '#description' => t('If there are related terms, should they be listed?'),
- );
-
- $form['optional']['taxonomy_list_synonyms'] = array(
- '#type' => 'checkbox',
- '#title' => t('Show synonyms for the term'),
- '#default_value' => variable_get('taxonomy_list_synonyms', false),
- '#description' => t('If there are synonyms for the term, should they be listed?'),
- );
-
- $form['optional']['taxonomy_list_show_parents'] = array(
- '#type' => 'checkbox',
- '#title' => t('Show parents of the term'),
- '#default_value' => variable_get('taxonomy_list_show_parents', false),
- '#description' => t('If this is a child term, show the parent structure?'),
- );
-
-// Counting settings.
- $form['count'] = array(
- '#type' => 'fieldset',
- '#title' => t('Count content'),
- '#collapsible' => true,
- '#collapsed' => true,
- );
-
- $count_opts = array(
- 'none' => t('No count.'),
- 'all' => t('Count all content types.'),
- 'by_type' => t('Count by content type.'),
- 'not_zero' => t("Count by type, don't show zero counts."),
- );
- $form['count']['taxonomy_list_count'] = array(
- '#type' => 'radios',
- '#title' => t('Count content types'),
- '#default_value' => variable_get('taxonomy_list_count', 0),
- '#options' => $count_opts,
- '#description' => t('How Taxonomy List counts the content types for terms.'),
- '#prefix' => '',
- '#suffix' => '
',
- );
-
- $form['count']['taxonomy_list_noshow'] = array(
- '#type' => 'checkbox',
- '#title' => t('Hide terms with no content'),
- '#default_value' => variable_get('taxonomy_list_noshow', false),
- '#description' => t('Do not show the term if there is no content using the term.'),
- );
-
-// Taxonomy Image settings.
- if (module_exists('taxonomy_image')) {
- $form['taxonomy_image'] = array(
- '#type' => 'fieldset',
- '#title' => t('Taxonomy Image'),
- '#description' => t('The taxonomy Image module is available.'),
- '#collapsible' => true,
- '#collapsed' => true,
- );
-
- $form['taxonomy_image']['taxonomy_list_show_image'] = array(
- '#type' => 'checkbox',
- '#title' => t('Show taxonomy image?'),
- '#default_value' => variable_get('taxonomy_list_show_image', 1),
- '#description' => t('Display the taxonomy image?'),
- );
-
- if (variable_get('taxonomy_image_wrapper', false)) {
- $form['taxonomy_image']['taxonomy_list_show_image']['#description'] .= ' '. t('Note that Taxonomy Image already provides a wrapper <div>, which may be styled individually.');
- }
-
- $img_link_opts = array(
- 'term' => t('Term path (e.g. taxonomy/term/xxx).'),
- 'big' => t('Full size image.'),
- );
- $form['taxonomy_image']['taxonomy_list_image_link'] = array(
- '#type' => 'radios',
- '#options' => $img_link_opts,
- '#title' => t('Show taxonomy image'),
- '#default_value' => variable_get('taxonomy_list_image_link', 'term'),
- '#description' => t('Display the taxonomy image?'),
- '#prefix' => '',
- '#suffix' => '
',
- );
- }
-
- return system_settings_form($form);
-}
+'. t('The Taxonomy List module adds pages that list all terms in a vocabulary (category). In addition, when the Taxonomy Image module is installed, these lists can include an image for each term.') .'';
+ }
+}
+
+/**
+ * Implementation of hook_perm().
+ */
+function taxonomy_list_perm() {
+ return array('administer taxonomy_list');
+}
+
+/**
+ * Implementation of hook_menu().
+ */
+function taxonomy_list_menu() {
+ $items = array();
+
+ $items['admin/settings/taxonomy_list'] = array(
+ 'title' => 'Taxonomy List',
+ 'description' => 'Customize how Taxonomy List displays terms on vocabulary pages.',
+ 'page callback' => 'drupal_get_form',
+ 'page arguments' => array('taxonomy_list_admin_settings'),
+ 'access arguments' => array('administer site configuration'),
+ 'type' => MENU_NORMAL_ITEM,
+ );
+
+ $items['taxonomy/vocabulary/%'] = array(
+ 'page callback' => 'taxonomy_list_show',
+ 'page arguments' => array(2),
+ 'access arguments' => array('access content'),
+ 'type' => MENU_CALLBACK,
+ );
+
+ return $items;
+}
+
+/**
+ * Implementation of hook_init().
+ */
+function taxonomy_list_init() {
+ drupal_add_css(drupal_get_path('module', 'taxonomy_list') .'/taxonomy_list.css');
+}
+
+/**
+ * Implementation of hook_theme().
+ */
+function taxonomy_list_theme() {
+ return array(
+ 'taxonomy_list_admin_links' => array(
+ 'arguments' => array('vids'),
+ ),
+ 'taxonomy_list_vocabulary' => array(
+ 'arguments' => array('vocabulary'),
+ ),
+ 'taxonomy_list_term' => array(
+ 'arguments' => array('term', 'vocabulary', 'controls'),
+ ),
+ 'taxonomy_list_get_table' => array(
+ 'arguments' => array('term', 'vocabulary', 'controls', 'depth'),
+ ),
+ );
+}
+
+/**
+ * Show the category list
+ */
+function taxonomy_list_show($str_vids, $max_depth = 'all', $op = null, $columns = null) {
+ if (preg_match('/^([0-9]+[+ ])+[0-9]+$/', $str_vids)) {
+ // The '+' character in a query string may be parsed as ' '.
+ $vids = preg_split('/[+ ]/', $str_vids);
+ }
+ else if (preg_match('/^[0-9]+$/', $str_vids) ) {
+ $vids = array($str_vids);
+ }
+
+ if (count($vids) <= 0) {
+ drupal_not_found();
+ return;
+ }
+
+ // Do we want to list the nodes?
+ if ($op == 'list') {
+ return taxonomy_list_nodes_render($vids, $max_depth);
+ }
+
+ $controls = array(
+ 'show_image' => variable_get('taxonomy_list_show_image', 1),
+ 'cells_per_row' => $columns ? $columns : variable_get('taxonomy_list_cell_per_row', 2),
+ 'count_type' => variable_get('taxonomy_list_count', 'none'),
+ 'no_show' => variable_get('taxonomy_list_noshow', false),
+ 'edit_link' => $op == 'block' ? false : variable_get('taxonomy_list_edit_link', false),
+ 'search_link' => $op == 'block' ? false : variable_get('taxonomy_list_search_link', false),
+ 'rss_link' => variable_get('taxonomy_list_rss_link', false),
+ 'image_link' => variable_get('taxonomy_list_image_link', 'term'),
+ 'destination' => drupal_get_destination(),
+ 'taxonomy_image' => module_exists('taxonomy_image'),
+ 'list_mode' => variable_get('taxonomy_list_list_mode', 0),
+ 'max_depth' => $max_depth == 'all' ? 9999999 : $max_depth,
+ 'related' => variable_get('taxonomy_list_related', false),
+ 'synonyms' => variable_get('taxonomy_list_synonyms', false),
+ 'show_parents' => variable_get('taxonomy_list_show_parents', false),
+ );
+
+ if ($controls['cells_per_row'] > 0) {
+ $controls['cell_width'] = floor(100 / $controls['cells_per_row']);
+ }
+ else {
+ $controls['cell_width'] = 100;
+ }
+
+ $vocab_titles = array();
+ $total_terms = 0;
+
+ $output = '';
+
+ foreach ($vids as $vid) {
+ $vocab = taxonomy_vocabulary_load($vid);
+ $vocab_titles[] = $vocab->name;
+
+ switch ($controls['list_mode']) {
+ case 0:
+ // Hierarchical. Only get first level, because _get_table will do children.
+ $terms = taxonomy_get_tree($vid, 0, -1, 1);
+ break;
+
+ case 1:
+ // Flat. Get all terms.
+ $terms = taxonomy_get_tree($vid, 0, -1, $max_depth);
+ break;
+ }
+
+ $c = count($terms);
+ if ($c <= 0) {
+ // This vocab has no term, skip.
+ continue;
+ }
+ $total_terms += $c;
+
+ $output .= theme('taxonomy_list_vocabulary', $vocab, variable_get('taxonomy_list_types', false), (count($vids) > 1));
+
+ $output .= theme('taxonomy_list_get_table', $terms, $vocab, $controls, 1);
+ }
+ if ($op != 'block') {
+ drupal_set_title(implode(variable_get('taxonomy_list_title_separator', ' & '), $vocab_titles));
+ }
+
+ $output .= '
'; // class="taxonomy-list"
+
+ if ($total_terms == 0) {
+ drupal_not_found();
+ return;
+ }
+
+ if ($op != 'block') {
+ $output .= theme('taxonomy_list_admin_links', $vids);
+ }
+
+ return $output;
+}
+
+/**
+ * Pad the remaining cells in the table
+ */
+function _taxonomy_list_pad_row(&$cells, &$rows, $cells_per_row) {
+ $cellscount = count($cells);
+
+ if ($cellscount > 0) {
+ // padding
+ for ($j = $cellscount; $j < $cells_per_row; $j++) {
+ $cells[] = ' ';
+ }
+ $rows[] = array('data' => $cells);
+ $cells = array();
+ }
+}
+/**
+ * Generate cascaded tables with terms and sub terms inside
+ */
+function theme_taxonomy_list_get_table($terms, $vocabulary, $controls, $depth) {
+ // list of terms those already rendered
+ static $done = array();
+ $cells = array();
+ $rows = array();
+
+ foreach ($terms as $term) {
+ // Have we already seen this term?
+ if (isset($done[$term->tid])) {
+ continue;
+ }
+
+ // Indicate that we've already done this term and save its name.
+ $done[$term->tid] = $term->name;
+
+ // Taxonomy_get_children does not provide depth or parents.
+ if (!isset($term->depth)) {
+ $term->depth = $depth;
+ }
+
+ if ($depth < $controls['max_depth']) {
+ $children = taxonomy_get_children($term->tid, $vocabulary->vid);
+ }
+ else {
+ $children = null;
+ }
+ $has_children = $children && ($controls['list_mode'] == 0);
+
+ if ($has_children) {
+ // Pad the row so the parent term will start at the begining of the next row.
+ _taxonomy_list_pad_row($cells, $rows, $controls['cells_per_row']);
+ }
+
+ // TODO: consider a depth attribute for parents.
+ $cell = $has_children ? '' : null;
+
+ $stuff = theme('taxonomy_list_term', $term, $vocabulary, $controls);
+ // Was there something in the cell?
+ if (!$stuff) {
+ continue;
+ }
+ $cell .= $stuff;
+
+ $cell .= '
'; // class="taxonomy-list-item"
+
+ if ($has_children) {
+ $cell .= '
';
+ $cell .= theme('taxonomy_list_get_table', $children, $vocabulary, $controls, $depth + 1);
+ $cell .= '
'; // class="taxonomy-list-children"
+ $cell .= ''; // class="taxonomy-list-cascade"
+ }
+
+ if ($has_children) {
+ // Span the cell to cover the whole row, and then the
+ // next term will start at the begining of the next row
+ $cells[] = array('data' => $cell, 'width' => '100%', 'colspan' => $controls['cells_per_row']);
+ $rows[] = array('data' => $cells);
+ $cells = array();
+ }
+ else {
+ $cells[] = array('data' => $cell, 'width' => $controls['cell_width'] .'%');
+
+ // add cell into the row, advance row if it reach the end of row
+ if (count($cells) % $controls['cells_per_row'] == 0) {
+ $rows[] = array('data' => $cells);
+ $cells = array();
+ }
+ }
+ }
+
+ // ensure that the table will be in good shape
+ // by padding the last row of the table
+ _taxonomy_list_pad_row($cells, $rows, $controls['cells_per_row']);
+
+ $table_attrs = array(
+ 'id' => 'taxonomy-list-table-'. $vocabulary->vid,
+ 'class' => 'taxonomy-list-table',
+ );
+ return theme('table', array(), $rows, $table_attrs);
+}
+
+/**
+ * Select and render the nodes in the chosen vocabularies.
+ */
+function taxonomy_list_nodes_render($vids, $max_depth) {
+ $output = '';
+ $terms = array();
+ // Get vocabulary names and list of tids.
+ foreach ($vids as $vid) {
+ $vocab = taxonomy_vocabulary_load($vid);
+ $vocab_titles[] = $vocab->name;
+ // Taxonomy_select_nodes will do the depth part for us, so we just get the top terms.
+ $terms = array_merge($terms, array_map('_taxonomy_get_tid_from_term', taxonomy_get_tree($vid, 0, -1, 1)));
+ }
+ drupal_set_title(implode(variable_get('taxonomy_list_title_separator', ' & '), $vocab_titles));
+ sort($terms);
+
+ // Render all nodes in a pager using taxonomy function.
+ $output .= taxonomy_render_nodes(taxonomy_select_nodes($terms, 'or', $max_depth));
+
+ $output .= '
'; // class="taxonomy-list"
+ return $output;
+}
+
+/**
+ * Theme the admin links.
+ */
+function theme_taxonomy_list_admin_links($vids) {
+ $destination = drupal_get_destination();
+ $output = '';
+ $links = array();
+
+ if (user_access('administer taxonomy')) {
+ foreach ($vids as $vid) {
+ $vocabulary = taxonomy_vocabulary_load($vid);
+ $links['taxonomy_list_add_'. $vid] = array(
+ 'title' => t('Add to "!name"', array('!name' => $vocabulary->name)),
+ 'href' => 'admin/content/taxonomy/'. $vocabulary->vid .'/add/term',
+// 'query' => $destination, // Term adds won't come back.
+ );
+ $links['taxonomy_list_edit_'. $vid] = array(
+ 'title' => t('Edit "!name"', array('!name' => $vocabulary->name)),
+ 'href' => 'admin/content/taxonomy/edit/vocabulary/'. $vocabulary->vid,
+ 'query' => $destination,
+ );
+ }
+ }
+ if (user_access('administer taxonomy_list')) {
+ $links['taxonomy_list_admin'] = array(
+ 'title' => t('Taxonomy list settings'),
+ 'href' => 'admin/settings/taxonomy_list',
+ 'query' => $destination,
+ );
+ }
+
+ $output .= theme('links', $links);
+ $output .= '
';
+ return $output;
+}
+
+/**
+ * Theme the vocabulary.
+ */
+function theme_taxonomy_list_vocabulary($vocabulary, $types = false, $title = true) {
+ $output = '';
+ if ($title) {
+ $output .= '
'. $vocabulary->name .'
';
+ }
+ $output .= '
'. $vocabulary->description .'
';
+ if ($types) {
+// $list = array_intersect_key(node_get_types('names'), array_flip($vocabulary->nodes)); /* php 5.1 */
+ $list = array_flip(array_intersect(array_flip(node_get_types('names')), $vocabulary->nodes));
+ $output .= '
'. t('Used for content types') .': '. implode(', ', $list) .'
';
+ }
+ $output .= '
';
+ if ($controls['taxonomy_image'] && $controls['show_image']) {
+ $links = array();
+ switch ($controls['image_link']) {
+ case 'term':
+ // Must use the 'html' flag for the l function.
+ $links['taxonomy-list-image'] = array(
+ 'title' => taxonomy_image_display($term->tid),
+ 'href' => taxonomy_term_path($term),
+ 'html' => true,
+ );
+ break;
+ case 'big':
+ $obj = taxonomy_image_get_object($term->tid);
+ $links['taxonomy-list-image'] = array(
+ 'title' => taxonomy_image_display($term->tid),
+ 'href' => $obj->url,
+ 'html' => true,
+ );
+ }
+ $output .= theme('links', $links);
+ }
+
+ switch ($controls['count_type']) {
+ case 'none':
+ $counter = null;
+ break;
+
+ case 'all':
+ $count = taxonomy_term_count_nodes($term->tid);
+ if ($count == 0 && $controls['no_show']) {
+ return null;
+ }
+ $counter = '
('. $count .')
';
+ break;
+
+ case 'not_zero':
+ case 'by_type':
+ $count_list = array();
+ $count = 0;
+ foreach ($vocabulary->nodes as $type) {
+ $this_count = taxonomy_term_count_nodes($term->tid, $type);
+ if ($this_count > 0 || $controls['count_type'] == 'by_type') {
+ $count_list[] = $type .': '. $this_count;
+ }
+ $count += $this_count;
+ }
+ if ($count == 0 && $controls['no_show']) {
+ return null;
+ }
+ if ($count_list) {
+ $counter = '
('. implode(', ', $count_list) .')
';
+ }
+ break;
+ }
+
+ // Create the term name as a taxonomy/term link with this term's tid as a named anchor (for related links).
+ $output .= '
'
+ . l($term->name, taxonomy_term_path($term), array('attributes' => array('class' => 'taxonomy-list-term'), 'html' => true));
+
+ // Do we want parents?
+ if ($controls['show_parents'] && $term->depth > 0) {
+ $parent_list = array();
+ $parents = taxonomy_get_parents_all($term->tid);
+ // Get rid of self;
+ unset($parents[0]);
+ foreach ($parents as $parent) {
+ $parent_list[] = l($parent->name, 'taxonomy/vocabulary/'. $vocabulary->vid, array('fragment' => $parent->tid));
+ }
+ $output .= '
[« '. implode(' « ', $parent_list) .']
';
+ }
+
+ // Add the counters.
+ $output .= $counter;
+
+ $links = array();
+ // Do we want edit link?
+ if (user_access('administer taxonomy') && $controls['edit_link']) {
+ $links['taxonomy-list-edit-link'] = array(
+ 'title' => 'edit term',
+ 'href' => 'admin/content/taxonomy/edit/term/'. $term->tid,
+ 'attributes' => array('title' => t('make changes to this term')),
+ 'query' => $controls['destination'],
+ );
+ }
+
+ // Do we want search link?
+ if (user_access('search content') && $controls['search_link']) {
+ $links['taxonomy-list-search-term'] = array(
+ 'title' => t('search for term'),
+ 'href' => 'search/node/"'. $term->name .'"',
+ 'attributes' => array('title' => t('search for content using this term')),
+// 'query' => $controls['destination'],
+ );
+ }
+
+ // Do we want RSS link?
+ if ($controls['rss_link']) {
+ $links['taxonomy-list-rss'] = array(
+ 'title' => '
',
+ 'href' => 'taxonomy/term/'. $term->tid .'/'. $controls['max_depth'] .'/feed',
+ 'attributes' => array('title' => t('create feed for this term')),
+ 'html' => true,
+// 'query' => $controls['destination'],
+ );
+ }
+
+ if ($links) {
+ $output .= theme('links', $links, array('class' => 'links inline'));
+ }
+
+ $output .= '
'. check_markup($term->description) .'
';
+// $output .= '
'. $term->description .'
';
+// $output .= '
';
+ $output .= ''. t('Related terms') .': '. implode(', ', $names);
+ $output .= '
';
+ }
+ }
+
+ if ($controls['synonyms']) {
+ if ($synonyms = taxonomy_get_synonyms($term->tid)) {
+ $output .= '';
+ $output .= ''. t('Synonyms') .': '. implode(', ', $synonyms);
+ $output .= '
';
+ }
+ }
+
+ $output .= ''; // class="taxonomy-list-item"
+ return $output;
+}
+
+/**
+ * Implementation of hook_block()
+ */
+function taxonomy_list_block($op = 'list', $delta = 0, $edit = array()) {
+ global $user;
+ switch ($op) {
+ case 'list':
+ $vocabularies = taxonomy_get_vocabularies();
+ foreach ($vocabularies as $vocabulary) {
+ $blocks[$vocabulary->vid]['info'] = t('Taxonomy List for @name', array('@name' => $vocabulary->name));
+ }
+ return $blocks;
+
+ case 'view':
+ // $delta is the vid.
+ $block['content'] = taxonomy_list_show($delta, 'all', 'block', 1);
+ return $block;
+
+ case 'configure':
+ $form = array();
+ return $form;
+
+ case 'save':
+ return;
+ } // end switch($op)
+}
+
+/**
+ * Menu callback; presents the admin settings form.
+ */
+function taxonomy_list_admin_settings() {
+ $form = array();
+
+ $form['taxonomy_list_info'] = array(
+ '#value' => t('The taxonomy_list module enable the URL to browse into each vocabulary, using the format of :
')
+ . t('"taxonomy/vocabulary/<vid>"')
+ . t('Together with the taxonomy_image.module, the list can be displayed with a image icon.
')
+ );
+
+// General settings.
+ $form['general'] = array(
+ '#type' => 'fieldset',
+ '#title' => t('General settings'),
+ '#collapsible' => true,
+ '#collapsed' => false,
+ );
+
+ $sep_opts = array(
+ ' & ' => 'ampersand (&)',
+ ' | ' => 'vertical bar (pipe)',
+ ', ' => 'comma (,)',
+ ' • ' => 'bullet',
+ ' – ' => 'en-dash (–)',
+ ' — ' => 'em-dash (—)',
+ ' _ ' => 'underscore',
+ );
+ $form['general']['taxonomy_list_title_separator'] = array(
+ '#type' => 'radios',
+ '#title' => t('Vocabulary separator'),
+ '#default_value' => variable_get('taxonomy_list_title_separator', ' & '),
+ '#options' => $sep_opts,
+ '#description' => t('This is the character that separates multiple vocabulary names in the page title.'),
+ '#prefix' => '',
+ '#suffix' => '
',
+ );
+
+ $form['general']['taxonomy_list_list_mode'] = array(
+ '#type' => 'radios',
+ '#title' => t('List Mode'),
+ '#default_value' => variable_get('taxonomy_list_list_mode', 0),
+ '#options' => array(
+ '0' => t("Hierarchical - Subcategories as a table inside their parent's cell."),
+ '1' => t('Flat - All terms are listed as the same level in the grid.'),
+ ),
+ '#description' => t('How Taxonomy List displays the list of terms.'),
+// '#prefix' => '',
+// '#suffix' => '
',
+ );
+
+ $form['general']['taxonomy_list_cell_per_row'] = array(
+ '#type' => 'textfield',
+ '#title' => t('Terms per row'),
+ '#size' => 5,
+ '#default_value' => variable_get('taxonomy_list_cell_per_row', 2),
+ '#description' => t('Number of terms to be displayed on the same row.'),
+ );
+
+// General link settings.
+ $form['general']['link'] = array(
+ '#type' => 'fieldset',
+ '#title' => t('Link options'),
+ '#collapsible' => true,
+ '#collapsed' => false,
+ );
+
+ $form['general']['link']['taxonomy_list_edit_link'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Add "edit term" link'),
+ '#default_value' => variable_get('taxonomy_list_edit_link', false),
+ '#description' => t('Should I add an "edit term" link to the display for authorized users?'),
+ );
+
+ if (module_exists('search')) {
+ $form['general']['link']['taxonomy_list_search_link'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Add "search for term" link'),
+ '#default_value' => variable_get('taxonomy_list_search_link', false),
+ '#description' => t('Should I add an "search for term" link to the display for authorized users?'),
+ );
+ }
+
+ $form['general']['link']['taxonomy_list_rss_link'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Add RSS link'),
+ '#default_value' => variable_get('taxonomy_list_rss_link', false),
+ '#description' => t('Should I add an RSS link (icon) to the display?'),
+ );
+
+// Optional settings.
+ $form['optional'] = array(
+ '#type' => 'fieldset',
+ '#title' => t('Optional information'),
+ '#collapsible' => true,
+ '#collapsed' => true,
+ );
+
+ $form['optional']['taxonomy_list_types'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Show content types'),
+ '#default_value' => variable_get('taxonomy_list_types', false),
+ '#description' => t('Do you want to display a list of the content types for the vocabulary?'),
+ );
+
+ $form['optional']['taxonomy_list_related'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Show related terms'),
+ '#default_value' => variable_get('taxonomy_list_related', false),
+ '#description' => t('If there are related terms, should they be listed?'),
+ );
+
+ $form['optional']['taxonomy_list_synonyms'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Show synonyms for the term'),
+ '#default_value' => variable_get('taxonomy_list_synonyms', false),
+ '#description' => t('If there are synonyms for the term, should they be listed?'),
+ );
+
+ $form['optional']['taxonomy_list_show_parents'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Show parents of the term'),
+ '#default_value' => variable_get('taxonomy_list_show_parents', false),
+ '#description' => t('If this is a child term, show the parent structure?'),
+ );
+
+// Counting settings.
+ $form['count'] = array(
+ '#type' => 'fieldset',
+ '#title' => t('Count content'),
+ '#collapsible' => true,
+ '#collapsed' => true,
+ );
+
+ $count_opts = array(
+ 'none' => t('No count.'),
+ 'all' => t('Count all content types.'),
+ 'by_type' => t('Count by content type.'),
+ 'not_zero' => t("Count by type, don't show zero counts."),
+ );
+ $form['count']['taxonomy_list_count'] = array(
+ '#type' => 'radios',
+ '#title' => t('Count content types'),
+ '#default_value' => variable_get('taxonomy_list_count', 0),
+ '#options' => $count_opts,
+ '#description' => t('How Taxonomy List counts the content types for terms.'),
+ '#prefix' => '',
+ '#suffix' => '
',
+ );
+
+ $form['count']['taxonomy_list_noshow'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Hide terms with no content'),
+ '#default_value' => variable_get('taxonomy_list_noshow', false),
+ '#description' => t('Do not show the term if there is no content using the term.'),
+ );
+
+// Taxonomy Image settings.
+ if (module_exists('taxonomy_image')) {
+ $form['taxonomy_image'] = array(
+ '#type' => 'fieldset',
+ '#title' => t('Taxonomy Image'),
+ '#description' => t('The taxonomy Image module is available.'),
+ '#collapsible' => true,
+ '#collapsed' => true,
+ );
+
+ $form['taxonomy_image']['taxonomy_list_show_image'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Show taxonomy image?'),
+ '#default_value' => variable_get('taxonomy_list_show_image', 1),
+ '#description' => t('Display the taxonomy image?'),
+ );
+
+ if (variable_get('taxonomy_image_wrapper', false)) {
+ $form['taxonomy_image']['taxonomy_list_show_image']['#description'] .= ' '. t('Note that Taxonomy Image already provides a wrapper <div>, which may be styled individually.');
+ }
+
+ $img_link_opts = array(
+ 'term' => t('Term path (e.g. taxonomy/term/xxx).'),
+ 'big' => t('Full size image.'),
+ );
+ $form['taxonomy_image']['taxonomy_list_image_link'] = array(
+ '#type' => 'radios',
+ '#options' => $img_link_opts,
+ '#title' => t('Show taxonomy image'),
+ '#default_value' => variable_get('taxonomy_list_image_link', 'term'),
+ '#description' => t('Display the taxonomy image?'),
+ '#prefix' => '',
+ '#suffix' => '
',
+ );
+ }
+
+ return system_settings_form($form);
+}