*is a wildcard. Example paths are blog for the blog page and blog/* for every personal blog. The list must contain at least one path."), + '#default_value' => $page->path, + '#size' => 60, + '#required' => TRUE, + ); + + $form['weight'] = array( + '#type' => 'weight', + '#title' => t('Weight'), + '#description' => t('Pages with lower weight will be considered first. Only the first matching page will be used.'), + '#delta' => 10, + '#default_value' => $page->weight, + ); + + $form['enabled'] = array( + '#type' => 'checkbox', + '#title' => t('Enabled'), + '#default_value' => $page->enabled, + ); + + $form['nodewords'] = $nodeword_form; $form['nodewords']['#tree'] = TRUE; $form['submit'] = array( @@ -210,12 +224,11 @@ function nodewords_pages_edit($form_stat * Validate function for the meta tags edit page. */ function nodewords_pages_edit_validate($form, &$form_state) { - if ($path = trim($form_state['values']['path'])) { - if ($path[0] == '/') { - form_set_error('path', t('The path must not start with a slash.')); - return; - } + if (trim($form_state['values']['name']) == '') { + form_set_error('name', t('The name contains only spaces, and other not printable characters.')); + } + if (($path = trim($form_state['values']['path'])) != '') { $bool = db_result( db_query("SELECT 1 FROM {nodewords_custom} WHERE path = '%s' AND pid <> %d", $path, @@ -228,7 +241,7 @@ function nodewords_pages_edit_validate($ } } else { - form_set_error('path', t('The path must not contain only spaces.')); + form_set_error('path', t('The path contains only spaces, and other not printable characters.')); } } @@ -238,10 +251,11 @@ function nodewords_pages_edit_validate($ function nodewords_pages_edit_submit($form, &$form_state) { $form_state['values']['path'] = trim($form_state['values']['path']); - nodewords_save_tags(NODEWORDS_MT_TYPE_PAGE, $form_state['values']['path'], $form_state['values']['nodewords']); - drupal_write_record('nodewords_custom', $form_state['values'], isset($form_state['values']['pid']) ? 'pid' : NULL); + nodewords_save_tags(NODEWORDS_TYPE_PAGE, $form_state['values']['path'], $form_state['values']['nodewords'], TRUE); + drupal_write_record('nodewords_custom', $form_state['values'], isset($form_state['values']['pid']) ? 'pid' : array()); drupal_set_message(t('The configuration options have been saved.')); + $form_state['redirect'] = 'admin/content/nodewords/meta-tags/other'; } @@ -249,44 +263,39 @@ function nodewords_pages_edit_submit($fo * Menu callback: settings form. */ function nodewords_settings_form() { - $edit_options = array(); - $edit_tags = variable_get('nodewords_edit', array()); - $form = array(); - $head_options = array(); - $head_tags = variable_get('nodewords_head', array()); - $tags_info = nodewords_get_possible_tags(); - - _nodewords_check_enabled_modules(); - - foreach ($tags_info as $name => $info) { - $bool = ( - isset($info['tag:context:allowed']) && - in_array(NODEWORDS_MT_TYPE_NONE, $info['tag:context:allowed']) - ); - - if (!$bool) { - $edit_options[$name] = $info['widget:label']; + if (!empty($tags_info)) { + foreach ($tags_info as $name => $info) { + $edit_options[$name] = $head_options[$name] = $info['widget:label']; } - $head_options[$name] = $info['widget:label']; + uasort($edit_options, 'strnatcmp'); + uasort($head_options, 'strnatcmp'); + } + else { + drupal_set_message(t('There are no modules that implement meta tags. You need to enable at least one module between nodewords_basic.module, nodewords_extra.module, and nodewords_verification_tags.module that are listed under Meta tags in the modules page.', array('@modules-page' => url('admin/build/modules'))), 'error'); } - - uasort($edit_options, 'strnatcmp'); - uasort($head_options, 'strnatcmp'); $form['edit'] = array( '#type' => 'fieldset', '#title' => t('Meta tags to show on edit forms'), - '#description' => t('Select the meta tags you want to be able to edit; the meta tag edit fields will always be shown in the administration settings pages. The meta tags that appear only in the list of the meta tags output in HTML, are automatically set by a module.'), + '#description' => t('Select the meta tags you want to be able to edit.'), '#collapsible' => TRUE, ); - $form['edit']['nodewords_edit'] = array( - '#type' => 'checkboxes', - '#options' => $edit_options, - '#default_value' => $edit_tags, - '#checkall' => variable_get('nodewords_enable_checkall', FALSE), - ); + if (!empty($tags_info)) { + $form['edit']['nodewords_edit'] = array( + '#type' => 'checkboxes', + '#options' => $edit_options, + '#default_value' => $edit_tags, + '#checkall' => TRUE, + ); + } + else { + $form['edit']['nodewords_edit'] = array( + '#type' => 'value', + '#value' => $edit_tags, + ); + } $form['head'] = array( '#type' => 'fieldset', @@ -295,53 +304,110 @@ function nodewords_settings_form() { '#collapsible' => TRUE, ); - $form['head']['nodewords_head'] = array( - '#type' => 'checkboxes', - '#options' => $head_options, - '#default_value' => $head_tags, - '#checkall' => variable_get('nodewords_enable_checkall', FALSE), + if (!empty($tags_info)) { + $form['head']['nodewords_head'] = array( + '#type' => 'checkboxes', + '#options' => $head_options, + '#default_value' => $head_tags, + '#checkall' => TRUE, + ); + } + else { + $form['head']['nodewords_head'] = array( + '#type' => 'value', + '#value' => $head_tags, + ); + } + + $form['metatags_creation'] = array( + '#type' => 'fieldset', + '#title' => t('Meta tags creation options'), + '#description' => t('These options change the way the meta tags are generated.'), + '#collapsible' => TRUE, ); - if (function_exists('taxonomy_get_vocabularies')) { - $options = array(); + $form['metatags_creation']['nodewords_enable_user_metatags'] = array( + '#type' => 'checkbox', + '#title' => t('Enable the user profile meta tags'), + '#default_value' => variable_get('nodewords_enable_user_metatags', TRUE), + ); - foreach (taxonomy_get_vocabularies() as $vocabulary) { - $options[$vocabulary->vid] = check_plain($vocabulary->name); - } + $form['metatags_creation']['nodewords_list_repeat'] = array( + '#type' => 'checkbox', + '#title' => t('Repeat meta tags for lists'), + '#description' => t('Some search engines punish sites that use the same meta tags on different pages. Uncheck this option if you want to suppress the repetition of the same meta tags on pages that use the pager - if unchecked, Drupal will only display the meta tags for the first page and not for subsequent pages. If unsure, select this option.'), + '#default_value' => variable_get('nodewords_list_repeat', FALSE), + ); - if ($count = count($options)) { - $form['taxonomy'] = array( - '#type' => 'fieldset', - '#title' => t('Taxonomy'), - '#collapsible' => TRUE, - ); - $form['taxonomy']['nodewords_keyword_vids'] = array( - '#type' => $count > 10 ? 'select' : 'checkboxes', - '#title' => t('Auto-keywords vocabularies'), - '#description' => t('Select the vocabularies which contain terms you want to add to the keywords meta tag for nodes. The terms of these vocabularies are added before the global keywords but after the page-specific keywords.'), - '#default_value' => variable_get('nodewords_keyword_vids', array()), - '#options' => $options, - '#multiple' => TRUE, - ); + $form['metatags_creation']['nodewords_use_frontpage_tags'] = array( + '#type' => 'checkbox', + '#title' => t('Use front page meta tags'), + '#description' => t('Check this option if you want to use the meta tags for the front page even if the default front page specified is a view, panel or node - in this case, the meta tags specified for the view, panel or node will be ignored. If you want to use the meta tags of the view, panel or node instead, uncheck this option. If unsure, select this option and specify the meta tags you want on the meta tags for the front page.', array('@front-page-url' => url('admin/content/nodewords/meta-tags/frontpage'), '@site-settings-url' => url('admin/settings/site-information'))), + '#default_value' => variable_get('nodewords_use_frontpage_tags', TRUE), + ); - if ($count > 10) { - $form['taxonomy']['nodewords_keyword_vids']['#multiple'] = TRUE; - } - elseif ($count > 2) { - // Add support for Check All if the checkboxes are more than two. - $form['taxonomy']['nodewords_keyword_vids']['#checkall'] = variable_get('nodewords_enable_checkall', FALSE); - } - } + $default_size = variable_get('nodewords_max_size', 350); + + $form['metatags_creation']['nodewords_max_size'] = array( + '#type' => 'textfield', + '#title' => t('Maximum meta tags length'), + '#description' => t('The maximum length to use for the meta tags form fields.'), + '#default_value' => $default_size, + '#required' => TRUE, + '#element_validate' => array('nodewords_max_size_validate'), + '#size' => 6, + '#maxlength' => 6, + ); + + if ($default_size < 350) { + $form['metatags_creation']['nodewords_max_size']['#description'] .= ' ' . t('Most of the search engines are now indexing 350 characters, which is not the maximum length actually set for the meta tags. See Official Google Blog: Two new improvements to Google results pages for more information.', array('@google-blog' => 'http://googleblog.blogspot.com/2009/03/two-new-improvements-to-google-results.html')); } - $form['advanced'] = array( + $form['metatags_creation']['node_teaser'] = array( '#type' => 'fieldset', - '#title' => t('Advanced options'), - '#description' => t('These options are for advanced uses. The average user should not change the value set by default from the module.'), + '#title' => t('Node teaser options'), + '#description' => t('These options are for the generation of meta tags content from the node teaser.'), '#collapsible' => TRUE, ); - $form['advanced']['nodewords_enable_checkall'] = array( + $form['metatags_creation']['node_teaser']['nodewords_use_alt_attribute'] = array( + '#type' => 'checkbox', + '#title' => t('Include the attribute ALT of images in the description meta tag created from the node teaser'), + '#default_value' => variable_get('nodewords_use_alt_attribute', TRUE), + ); + + $options = array( + 'imagebrowser' => 'imagebrowser.module', + 'img_assist' => 'img_assist.module', + ); + + $form['metatags_creation']['node_teaser']['nodewords_filter_modules_output'] = array( + '#type' => 'checkboxes', + '#title' => t('Filter the text added by third-party modules'), + '#options' => $options, + '#default_value' => variable_get('nodewords_filter_modules_output', array()), + '#checkall' => TRUE, + ); + + $form['metatags_creation']['node_teaser']['nodewords_filter_regexp'] = array( + '#type' => 'textfield', + '#title' => t('Custom regular expression'), + '#description' => t('A regular expression used to filter the text added in the node teaser from a third-party module. The regular expression uses the Perl compatible syntax.'), + '#element_validate' => array('nodewords_filter_regexp_validate'), + '#default_value' => variable_get('nodewords_filter_regexp', ''), + '#size' => 60, + ); + + $form['metatags_creation']['taxonomy'] = array(); + + $form['third_party_integration'] = array( + '#type' => 'fieldset', + '#title' => t('Third party modules integration'), + '#description' => t('These options enable the integration between Nodewords and other modules.'), + '#collapsible' => TRUE, + ); + + $form['third_party_integration']['nodewords_enable_checkall'] = array( '#type' => 'checkbox', '#title' => t( 'Enable the integration with checkall.module', @@ -351,16 +417,16 @@ function nodewords_settings_form() { ); if (!module_exists('checkall')) { - $form['advanced']['nodewords_enable_checkall']['#description'] = t( + $form['third_party_integration']['nodewords_enable_checkall']['#description'] = t( 'The module checkall.module is not enabled, or installed.' ); if (!variable_get('nodewords_enable_checkall', FALSE)) { - $form['advanced']['nodewords_enable_checkall']['#disabled'] = TRUE; + $form['third_party_integration']['nodewords_enable_checkall']['#disabled'] = TRUE; } } - $form['advanced']['nodewords_enable_tokens'] = array( + $form['third_party_integration']['nodewords_enable_tokens'] = array( '#type' => 'checkbox', '#title' => t( 'Enable the integration with token.module', @@ -373,16 +439,14 @@ function nodewords_settings_form() { ); if (!module_exists('token')) { - $form['advanced']['nodewords_enable_tokens']['#description'] .= ' ' . t( - 'The module token.module is not enabled, or installed.' - ); + $form['third_party_integration']['nodewords_enable_tokens']['#description'] .= ' ' . t('The module token.module is not enabled, or installed.'); if (!variable_get('nodewords_enable_tokens', TRUE)) { - $form['advanced']['nodewords_enable_tokens']['#disabled'] = TRUE; + $form['third_party_integration']['nodewords_enable_tokens']['#disabled'] = TRUE; } } - $form['advanced']['nodewords_enable_vertical_tabs'] = array( + $form['third_party_integration']['nodewords_enable_vertical_tabs'] = array( '#type' => 'checkbox', '#title' => t( 'Enable the integration with vertical_tabs.module', @@ -392,58 +456,15 @@ function nodewords_settings_form() { ); if (!module_exists('vertical_tabs')) { - $form['advanced']['nodewords_enable_vertical_tabs']['#description'] = t( + $form['third_party_integration']['nodewords_enable_vertical_tabs']['#description'] = t( 'The module vertical_tabs.module is not enabled, or installed.' ); if (!variable_get('nodewords_enable_vertical_tabs', FALSE)) { - $form['advanced']['nodewords_enable_vertical_tabs']['#disabled'] = TRUE; + $form['third_party_integration']['nodewords_enable_vertical_tabs']['#disabled'] = TRUE; } } - $form['advanced']['nodewords_enable_user_metatags'] = array( - '#type' => 'checkbox', - '#title' => t('Enable the user profile meta tags'), - '#default_value' => variable_get('nodewords_enable_user_metatags', TRUE), - ); - - $form['advanced']['nodewords_list_repeat'] = array( - '#type' => 'checkbox', - '#title' => t('Repeat meta tags for lists'), - '#description' => t('Some search engines punish sites that use the same meta tags on different pages. Uncheck this option if you want to suppress the repetition of the same meta tags on pages that use the pager - if unchecked, Drupal will only display the meta tags for the first page and not for subsequent pages. If unsure, select this option.'), - '#default_value' => variable_get('nodewords_list_repeat', FALSE), - ); - - $form['advanced']['nodewords_use_frontpage_tags'] = array( - '#type' => 'checkbox', - '#title' => t('Use front page meta tags'), - '#description' => t('Check this option if you want to use the meta tags for the front page even if the default front page specified is a view, panel or node - in this case, the meta tags specified for the view, panel or node will be ignored. If you want to use the meta tags of the view, panel or node instead, uncheck this option. If unsure, select this option and specify the meta tags you want on the meta tags for the front page.', array('@front-page-url' => url('admin/content/nodewords/meta-tags/frontpage'), '@site-settings-url' => url('admin/settings/site-information'))), - '#default_value' => variable_get('nodewords_use_frontpage_tags', TRUE), - ); - - $form['advanced']['nodewords_collapse_fieldset'] = array( - '#type' => 'checkbox', - '#title' => t('Show the meta tags fieldset as collapsed'), - '#default_value' => variable_get('nodewords_collapse_fieldset', FALSE), - ); - - $default_size = variable_get('nodewords_max_size', 350); - - $form['advanced']['nodewords_max_size'] = array( - '#type' => 'textfield', - '#title' => t('Maximum meta tags length'), - '#description' => t('The maximum length to use for the meta tags form fields.'), - '#default_value' => $default_size, - '#required' => TRUE, - '#element_validate' => array('nodewords_max_size_validate'), - '#size' => 6, - '#maxlength' => 6, - ); - - if ($default_size < 350) { - $form['advanced']['nodewords_max_size']['#description'] .= ' ' . t('Most of the search engines are now indexing 350 characters, which is not the maximum length actually set for the meta tags. See Official Google Blog: Two new improvements to Google results pages for more information.', array('@google-blog' => 'http://googleblog.blogspot.com/2009/03/two-new-improvements-to-google-results.html')); - } - foreach ($tags_info as $name => $info) { $function = $info['tag:function:prefix'] . '_settings_form'; $options = array( @@ -451,7 +472,7 @@ function nodewords_settings_form() { ); if (function_exists($function)) { - $function($form, '
' . t('On this page you can enter the meta tags for other pages of your site.') . '
'; + $output = '' . t('On this page you can enter the meta tags for other pages of your site. The meta tags set in these page are used before the ones set for nodes or user profiles, and they can ovverride those meta tags.') . '
'; break; case 'admin/content/nodewords/meta-tags/tracker': @@ -324,7 +324,7 @@ function nodewords_menu() { $items['admin/content/nodewords/meta-tags/errorpage_403'] = array( 'title' => 'Error 403 page', 'page callback' => 'drupal_get_form', - 'page arguments' => array('nodewords_tags_form', NODEWORDS_MT_TYPE_ERRORPAGE, '403'), + 'page arguments' => array('nodewords_tags_form', NODEWORDS_TYPE_ERRORPAGE, '403'), 'access arguments' => $admin_access, 'type' => MENU_LOCAL_TASK, 'file' => 'nodewords.admin.inc', @@ -333,7 +333,7 @@ function nodewords_menu() { $items['admin/content/nodewords/meta-tags/errorpage_404'] = array( 'title' => 'Error 404 page', 'page callback' => 'drupal_get_form', - 'page arguments' => array('nodewords_tags_form', NODEWORDS_MT_TYPE_ERRORPAGE, '404'), + 'page arguments' => array('nodewords_tags_form', NODEWORDS_TYPE_ERRORPAGE, '404'), 'access arguments' => $admin_access, 'type' => MENU_LOCAL_TASK, 'file' => 'nodewords.admin.inc', @@ -342,7 +342,7 @@ function nodewords_menu() { $items['admin/content/nodewords/meta-tags/frontpage'] = array( 'title' => 'Front page', 'page callback' => 'drupal_get_form', - 'page arguments' => array('nodewords_tags_form', NODEWORDS_MT_TYPE_FRONTPAGE), + 'page arguments' => array('nodewords_tags_form', NODEWORDS_TYPE_FRONTPAGE), 'access arguments' => $admin_access, 'type' => MENU_LOCAL_TASK, 'file' => 'nodewords.admin.inc', @@ -351,7 +351,7 @@ function nodewords_menu() { $items['admin/content/nodewords/meta-tags/tracker'] = array( 'title' => 'Tracker pages', 'page callback' => 'drupal_get_form', - 'page arguments' => array('nodewords_tags_form', NODEWORDS_MT_TYPE_TRACKER), + 'page arguments' => array('nodewords_tags_form', NODEWORDS_TYPE_TRACKER), 'access arguments' => $admin_access, 'type' => MENU_LOCAL_TASK, 'file' => 'nodewords.admin.inc', @@ -407,7 +407,7 @@ function nodewords_node_operations() { 'delete_metatags' => array( 'label' => t('Delete meta tags'), 'callback' => 'nodewords_mass_delete_tags', - 'callback arguments' => array('type' => NODEWORDS_MT_TYPE_NODE), + 'callback arguments' => array('type' => NODEWORDS_TYPE_NODE), ), ); @@ -420,26 +420,44 @@ function nodewords_node_operations() { function nodewords_nodeapi(&$node, $op, $teaser = NULL, $page = NULL) { switch ($op) { case 'delete': - nodewords_delete_tags(NODEWORDS_MT_TYPE_NODE, $node->nid); + nodewords_delete_tags( + NODEWORDS_TYPE_NODE, $node->nid, array('sid' => '*') + ); break; case 'insert': case 'update': if (isset($node->nodewords)) { - nodewords_save_tags(NODEWORDS_MT_TYPE_NODE, $node->nid, $node->nodewords); + nodewords_save_tags( + $node->nodewords, + NODEWORDS_TYPE_NODE, + $node->nid, + array( + 'sid' => $node->vid, + 'language' =>$node->language, + ) + ); } break; case 'load': return array( - 'nodewords' => nodewords_load_tags(NODEWORDS_MT_TYPE_NODE, $node->nid), + 'nodewords' => nodewords_load_tags( + NODEWORDS_TYPE_NODE, $node->nid, + array( + 'sid' => $node->vid, + 'language' => $node->language, + ) + ), ); case 'update index': - $tags = array(); + $output_tags = array(); $tag_options = array( - 'type' => NODEWORDS_MT_TYPE_NODE, + 'type' => NODEWORDS_TYPE_NODE, 'id' => $node->nid, + 'sid' => $node->vid, + 'language' => $node->language, ); if (isset($node->nodewords)) { @@ -461,7 +479,11 @@ function nodewords_nodeapi(&$node, $op, } } - return nodewords_output_tags($tags, 'update index'); + $output = nodewords_output_tags($output_tags, 'update index'); + $tag_options['output'] = 'update index'; + + drupal_alter('nodewords_tags_output', $output, $tag_options); + return $output; } return ''; @@ -479,8 +501,18 @@ function nodewords_perm() { * Implementation of hook_preprocess_page(). */ function nodewords_preprocess_page(&$variables) { - list($type, $id) = _nodewords_detect_type_and_id(); - drupal_set_html_head(nodewords_output_tags(nodewords_get_tags($type, $id))); + $parameters = array(); + $result = _nodewords_detect_type_and_id(); + $tags = nodewords_get_tags($result[0], $result[1]); + + $output = nodewords_output_tags($tags); + $parameters['type'] = $result[0]; + $parameters['id'] = $result[1]; + $parameters['sid'] = isset($result[2]) ? $result[2] : 0; + $parameters['output'] = 'head'; + + drupal_alter('nodewords_tags_output', $output, $parameters); + drupal_set_html_head($output); $variables['head'] = drupal_get_html_head(); } @@ -491,11 +523,11 @@ function nodewords_preprocess_page(&$var function nodewords_taxonomy($op, $type, $object = NULL) { if ($type == 'term') { $id = $object['tid']; - $type = NODEWORDS_MT_TYPE_TERM; + $type = NODEWORDS_TYPE_TERM; } elseif ($type == 'vocabulary') { $id = $object['vid']; - $type = NODEWORDS_MT_TYPE_VOCABULARY; + $type = NODEWORDS_TYPE_VOCABULARY; } else { return; @@ -509,7 +541,7 @@ function nodewords_taxonomy($op, $type, case 'insert': case 'update': if (isset($object['nodewords'])) { - nodewords_save_tags($type, $id, $object['nodewords']); + nodewords_save_tags($object['nodewords'], $type, $id); } break; } @@ -533,27 +565,27 @@ function nodewords_user($op, &$edit, &$a switch ($op) { case 'load': if (variable_get('nodewords_enable_user_metatags', TRUE)) { - $account->nodewords = nodewords_load_tags(NODEWORDS_MT_TYPE_USER, $account->uid); + $account->nodewords = nodewords_load_tags(NODEWORDS_TYPE_USER, $account->uid); } break; case 'delete': - nodewords_delete_tags(NODEWORDS_MT_TYPE_USER, $account->uid); + nodewords_delete_tags(NODEWORDS_TYPE_USER, $account->uid); break; case 'insert': case 'update': if (isset($edit['nodewords'])) { - nodewords_save_tags(NODEWORDS_MT_TYPE_USER, $account->uid, $edit['nodewords']); + nodewords_save_tags($edit['nodewords'], NODEWORDS_TYPE_USER, $account->uid); } break; case 'form': if ($category == 'account') { if (variable_get('nodewords_enable_user_metatags', TRUE)) { - $tags = nodewords_load_tags(NODEWORDS_MT_TYPE_USER, $account->uid); + $tags = nodewords_load_tags(NODEWORDS_TYPE_USER, $account->uid); $form['nodewords'] = nodewords_form( - NODEWORDS_MT_TYPE_USER, + NODEWORDS_TYPE_USER, $tags, array( 'page:permissions:additional' => 'administer users', @@ -575,7 +607,7 @@ function nodewords_user_operations() { 'delete_metatags' => array( 'label' => t('Delete meta tags'), 'callback' => 'nodewords_mass_delete_tags', - 'callback arguments' => array('type' => NODEWORDS_MT_TYPE_USER), + 'callback arguments' => array('type' => NODEWORDS_TYPE_USER), ), ); @@ -589,10 +621,28 @@ function nodewords_user_operations() { /** * Delete tags from table. */ -function nodewords_delete_tags($type, $id) { - db_query("DELETE FROM {nodewords} WHERE type = %d AND id = '%s'", $type, $id); +function nodewords_delete_tags($type, $id, $options = array()) { + $default_options = array( + 'sid' => 0, + 'language' => '*', + ); + $options += $default_options; + + $args = array($type); + $query = "DELETE FROM {nodewords} WHERE type = %d AND id = '%s'"; - if ($type == NODEWORDS_MT_TYPE_PAGE) { + if ($options['sid'] != '*') { + $args[] = $options['sid']; + $query .= ' AND sid = %d'; + } + if ($options['language'] != '*') { + $args[] = $options['language']; + $query .= " AND language = '%s'"; + } + + db_query($query, $args); + + if ($type == NODEWORDS_TYPE_PAGE) { db_query("DELETE FROM {nodewords_custom} WHERE path = '%s'", $id); } } @@ -609,6 +659,7 @@ function nodewords_delete_tags($type, $i * @return * An array as requested by the form API. */ +// TODO: Add the language option. function nodewords_form($type, $tags, $options = array()) { $default_options = array( 'fieldset' => TRUE, @@ -635,7 +686,7 @@ function nodewords_form($type, $tags, $o $tokens_support = FALSE; foreach ($tags_info as $name => $info) { - if ($type == NODEWORDS_MT_TYPE_DEFAULT) { + if ($type == NODEWORDS_TYPE_DEFAULT) { if (empty($edit_tags[$name]) && empty($head_tags[$name])) { continue; } @@ -646,7 +697,7 @@ function nodewords_form($type, $tags, $o if (!empty($info['tag:context:allowed'])) { $bool = ( - in_array(NODEWORDS_MT_TYPE_NONE, $info['tag:context:allowed']) || + in_array(NODEWORDS_TYPE_NONE, $info['tag:context:allowed']) || !in_array($type, $info['tag:context:allowed']) ); @@ -690,24 +741,24 @@ function nodewords_form($type, $tags, $o $form['#title'] = $options['fieldset:title']; $form['#tree'] = TRUE; $form['#collapsible'] = TRUE; - $form['#collapsed'] = variable_get('nodewords_collapse_fieldset', FALSE) || $collapsed; + $form['#collapsed'] = TRUE; $form['#weight'] = $options['fieldset:weight']; } if ($tokens_enabled && $tokens_support) { switch ($type) { - case NODEWORDS_MT_TYPE_ERRORPAGE: - case NODEWORDS_MT_TYPE_FRONTPAGE: - case NODEWORDS_MT_TYPE_PAGER: - case NODEWORDS_MT_TYPE_TRACKER: + case NODEWORDS_TYPE_ERRORPAGE: + case NODEWORDS_TYPE_FRONTPAGE: + case NODEWORDS_TYPE_PAGER: + case NODEWORDS_TYPE_TRACKER: $token_type = 'global'; break; - case NODEWORDS_MT_TYPE_NODE: + case NODEWORDS_TYPE_NODE: $token_type = 'node'; break; - case NODEWORDS_MT_TYPE_USER: + case NODEWORDS_TYPE_USER: $token_type = 'user'; break; @@ -791,53 +842,57 @@ function nodewords_get_possible_tags() { * * @param $type * Realm of the object the meta tags are associated with. - * This is one of the following: NODEWORDS_MT_TYPE_ERRORPAGE, - NODEWORDS_MT_TYPE_FRONTPAGE, NODEWORDS_MT_TYPE_NODE, - * NODEWORDS_MT_TYPE_PAGE, NODEWORDS_MT_TYPE_TERM, - NODEWORDS_MT_TYPE_TRACKER, NODEWORDS_MT_TYPE_VOCABULARY. + * This is one of the following: NODEWORDS_TYPE_ERRORPAGE, + * NODEWORDS_TYPE_FRONTPAGE, NODEWORDS_TYPE_NODE, + * NODEWORDS_TYPE_PAGE, NODEWORDS_TYPE_TERM, + * NODEWORDS_TYPE_TRACKER, NODEWORDS_TYPE_VOCABULARY. * @param $id * ID of the object to get the meta tags from. * This is one of the following: - * - NODEWORDS_MT_TYPE_ERRORPAGE => the HTML error code (403 or 404). - * - NODEWORDS_MT_TYPE_FRONTPAGE => 0. - * - NODEWORDS_MT_TYPE_NODE => the node ID. - * - NODEWORDS_MT_TYPE_PAGE => the page path. - * - NODEWORDS_MT_TYPE_PAGER => 0. - * - NODEWORDS_MT_TYPE_TERM => the term ID. - * - NODEWORDS_MT_TYPE_USER => the user ID. - * - NODEWORDS_MT_TYPE_VOCABULARY => the vocabulary ID. - * @param $filtered - * If TRUE, only the meta tags that the user configured for - * output will be returned. - * If FALSE, all meta tags will be returned. + * - NODEWORDS_TYPE_ERRORPAGE => the HTML error code (403 or 404). + * - NODEWORDS_TYPE_FRONTPAGE => 0. + * - NODEWORDS_TYPE_NODE => the node ID. + * - NODEWORDS_TYPE_PAGE => the page path. + * - NODEWORDS_TYPE_PAGER => 0. + * - NODEWORDS_TYPE_TERM => the term ID. + * - NODEWORDS_TYPE_USER => the user ID. + * - NODEWORDS_TYPE_VOCABULARY => the vocabulary ID. + * @param $options + * An array of options. * * @return * An associative array of the defined meta tags. */ -function nodewords_get_tags($type, $ids = array(''), $filtered = TRUE) { +function nodewords_get_tags($type, $id = '', $options = array()) { + global $language; + + $default_options = array( + 'sid' => 0, + 'filter' => TRUE, + 'language' => $language->language, + ); $head_tags = variable_get('nodewords_head', array()); $output_tags = array(); - - if (!is_array($ids)) { - $ids = array($ids); - } + $options += $default_options; $tag_options = array( - 'default' => nodewords_load_tags(), - 'ids' => $ids, 'type' => $type, + 'id' => $id, + 'sid' => $options['sid'], + 'default' => nodewords_load_tags(), + 'language' => $options['language'], ); - if ($type == NODEWORDS_MT_TYPE_PAGER) { + if ($type == NODEWORDS_TYPE_PAGER) { foreach (nodewords_get_possible_tags() as $name => $info) { // Filter out tags the user has chosen not to see - if ($filtered && empty($head_tags[$name])) { + if ($options['filter'] && empty($head_tags[$name])) { continue; } $bool = ( !empty($info['tag:context:allowed']) && - in_array(NODEWORDS_MT_TYPE_PAGER, $info['tag:context:allowed']) && + in_array(NODEWORDS_TYPE_PAGER, $info['tag:context:allowed']) && function_exists($function = $info['tag:function:prefix'] . '_prepare') ); @@ -850,12 +905,12 @@ function nodewords_get_tags($type, $ids } else { // User profiles meta tags are not enabled. - if ($type == NODEWORDS_MT_TYPE_USER && !variable_get('nodewords_enable_user_metatags', TRUE)) { + if ($type == NODEWORDS_TYPE_USER && !variable_get('nodewords_enable_user_metatags', TRUE)) { return array(); } // Load the values from the database - elseif (count($ids) == 1 && ($type != NODEWORDS_MT_TYPE_NODE || node_access('view', node_load($ids[0])))) { - $tags = nodewords_load_tags($type, $ids[0]); + elseif ($type != NODEWORDS_TYPE_NODE || node_access('view', node_load($id))) { + $tags = nodewords_load_tags($type, $id, $options); } else { $tags = array(); @@ -864,7 +919,7 @@ function nodewords_get_tags($type, $ids // Prepare the tags. foreach (nodewords_get_possible_tags() as $name => $info) { // Filter out tags the user has chosen not to see - if ($filtered && empty($head_tags[$name])) { + if ($options['filter'] && empty($head_tags[$name])) { continue; } @@ -875,8 +930,6 @@ function nodewords_get_tags($type, $ids } } } - - return $output_tags; } /** @@ -912,25 +965,42 @@ function nodewords_get_term($tid) { /** * Load tags from table. + * + * @param $type + * The type of object associated with the meta tags. + * @param $id + * The object ID. + * @param $options + * An array of options. + * + * @return + * An array of meta tags data as saved in the database table. */ -function nodewords_load_tags($type = NODEWORDS_MT_TYPE_DEFAULT, $id = '', $language = '') { + + +function nodewords_load_tags($type = NODEWORDS_TYPE_DEFAULT, $id = '', $options = array()) { + $default_options = array( + 'sid' => 0, + 'language' => '', + ); + $options += $default_options; $tags = array(); $tags_info = nodewords_get_possible_tags(); $count = db_result( db_query( - "SELECT COUNT(*) FROM {nodewords} WHERE type = '%s' AND id = '%s' AND language = '%s'", - $type, $id, $language + "SELECT COUNT(*) FROM {nodewords} WHERE type = '%s' AND id = '%s' AND sid = %d AND language = '%s'", + $type, $id, $options['sid'], $options['language'] ) ); - if (!$count && !empty($language)) { - $language = ''; + if (!$count && !empty($options['language'])) { + $options['language'] = ''; } $result = db_query( - "SELECT COUNT(*) FROM {nodewords} WHERE type = '%s' AND id = '%s' AND language = '%s'", - $type, $id, $language + "SELECT * FROM {nodewords} WHERE type = '%s' AND id = '%s' AND sid = %d AND language = '%s'", + $type, $id, $options['sid'], $options['language'] ); while ($row = db_fetch_object($result)) { @@ -939,8 +1009,8 @@ function nodewords_load_tags($type = NOD } } - if (empty($tags) && $type == NODEWORDS_MT_TYPE_TERM) { - return nodewords_load_tags(NODEWORDS_MT_TYPE_VOCABULARY, db_result(db_query('SELECT vid FROM {term_data} WHERE tid = %d', $id)), $language); + if (empty($tags) && $type == NODEWORDS_TYPE_TERM) { + return nodewords_load_tags(NODEWORDS_TYPE_VOCABULARY, db_result(db_query('SELECT vid FROM {term_data} WHERE tid = %d', $id)), $options); } return $tags; @@ -952,15 +1022,15 @@ function nodewords_load_tags($type = NOD * @param $ids * An array of IDs. * @param $type - * The type of the object associated with the IDs (NODEWORDS_MT_TYPE_NODE, - * NODEWORDS_MT_TYPE_USER, ...). + * The type of the object associated with the IDs (NODEWORDS_TYPE_NODE, + * NODEWORDS_TYPE_USER, ...). */ function nodewords_mass_delete_tags($ids, $type) { db_query("DELETE FROM {nodewords} WHERE id IN (" . db_placeholders($ids, 'varchar') . ") AND type = %d", array_merge($ids, array($type)) ); - if ($type == NODEWORDS_MT_TYPE_PAGE) { + if ($type == NODEWORDS_TYPE_PAGE) { db_query("DELETE FROM {nodewords_custom} WHERE path IN (" . db_placeholders($ids, 'varchar') . ")", $ids ); @@ -977,19 +1047,14 @@ function nodewords_mass_delete_tags($ids * @param $format * The format set for the node. * @param $options - * An array of options. The currently defined are: - * 'alt_attribute' - If TRUE, any tag img will be replaced with its attribute alt. - * size' - * The maximum allowed size; if it is zero, then the function will use - the value of the Drupal variable "nodewords_max_size". + * An array of options; currently, the only used is the maximum allowed + * length. * * @return * The string to use to populate the meta tag. */ function nodewords_metatag_from_teaser($text, $format, $options = array()) { $default_options = array( - 'alt_attribute' => FALSE, 'size' => variable_get('nodewords_max_size', 350), ); $options += $default_options; @@ -1004,12 +1069,6 @@ function nodewords_metatag_from_teaser($ } } - // Remove the string added from Image Assist. - $text = preg_replace('/\[img_assist.*\]/i', '', $text); - - // Initialize the helper function used for preg_replace_callback. - _nodewords_teaser_match_callback($alt_attribute, TRUE); - // Replace the meta tag img with the attribute alt, and strip off all the // HTML tags. $text = strip_tags( @@ -1019,8 +1078,23 @@ function nodewords_metatag_from_teaser($ ) ); + // Remove the strings added from third-party modules. + $modules = array_filter(variable_get('nodewords_filter_modules_output', array())); + + if (isset($modules['imagebrowser'])) { + $text = preg_replace("/\[ibimage[^[\]*\]/i", '', $text); + } + if (isset($modules['img_assist'])) { + $text = preg_replace("/\[img_assist[^[\]*\]/i", '', $text); + } + + // Remove the text matching the regular expression. + if ($regexp = trim(variable_get('nodewords_filter_regexp', ''))) { + $text = preg_replace("/" . $regexp . "/i", '', $text); + } + // Truncate the string at last space within the given size. - return truncate_utf8($text, $size, TRUE); + return truncate_utf8($text, $options['size'], TRUE); } /** @@ -1132,7 +1206,7 @@ function nodewords_page_load($pid) { return _nodewords_get_pages_data($pid); } -function nodewords_replace_tokens($type, $id, $content) { +function nodewords_replace_tokens($content, $type, $id, $sid = 0) { $bool = ( empty($content) || !module_exists('token') ); @@ -1142,20 +1216,20 @@ function nodewords_replace_tokens($type, } switch ($type) { - case NODEWORDS_MT_TYPE_ERRORPAGE: - case NODEWORDS_MT_TYPE_FRONTPAGE: - case NODEWORDS_MT_TYPE_PAGER: - case NODEWORDS_MT_TYPE_TRACKER: + case NODEWORDS_TYPE_ERRORPAGE: + case NODEWORDS_TYPE_FRONTPAGE: + case NODEWORDS_TYPE_PAGER: + case NODEWORDS_TYPE_TRACKER: $token_type = 'global'; $token_object = NULL; break; - case NODEWORDS_MT_TYPE_NODE: + case NODEWORDS_TYPE_NODE: $token_type = 'node'; - $token_object = node_load(array('vid' => $id)); + $token_object = node_load(array('vid' => $sid)); break; - case NODEWORDS_MT_TYPE_USER: + case NODEWORDS_TYPE_USER: $token_type = 'user'; $token_object = user_load($id); break; @@ -1170,16 +1244,18 @@ function nodewords_replace_tokens($type, /** * Update or insert tags in the table. */ -function nodewords_save_tags($type, $id, $tags, $options = array()) { +function nodewords_save_tags($tags, $type, $id, $options = array()) { global $user; static $tags_info; $default_options = array( + 'sid => 0', 'language' => '', 'log_message' => TRUE, ); $done = FALSE; $options += $default_options; + $sid = $options['sid']; if (!isset($tags_info)) { $tags_info = nodewords_get_possible_tags(); @@ -1194,12 +1270,18 @@ function nodewords_save_tags($type, $id, $content = $content['value']; } - $result = db_fetch_object(db_query("SELECT * FROM {nodewords} WHERE type = %d AND id = '%s' AND name = '%s' AND language = '%s'", $type, $id, $name, $language)); + $result = db_fetch_object( + db_query( + "SELECT * FROM {nodewords} WHERE type = %d AND id = '%s' AND sid = %d AND name = '%s' AND language = '%s'", + $type, $id, $sid, $name, $language + ) + ); if ($result === FALSE) { $row = new stdClass(); $row->type = $type; $row->id = $id; + $row->sid = $sid; $row->name = $name; } else { @@ -1208,10 +1290,16 @@ function nodewords_save_tags($type, $id, $row->content = $content; - drupal_write_record('nodewords', $row, $result !== FALSE ? 'mtid' : NULL); + drupal_write_record('nodewords', $row, $result !== FALSE ? 'mtid' : array()); if (!$done) { - watchdog('nodewords', 'User %name changed the meta tags for type %type (%id).', array('%name' => $user->name, '%type' => $type, '%id' => $id)); + watchdog( + 'nodewords', + 'User %name changed the meta tags for type %type (%id - %sid).', + array( + '%name' => $user->name, '%type' => $type, '%id' => $id, '%sid' => $sid + ) + ); $done = TRUE; } } @@ -1235,15 +1323,20 @@ function nodewords_save_tags($type, $id, * A string containing only unique items present in the string of concatenated * items. */ -function nodewords_unique($text, $separator = ',', $max_items = -1) { +function nodewords_unique_values($text, $options = array()) { + $default_options = array( + 'separator' => ',', + 'max_items' => -1, + ); $lc_values = array(); + $options += $default_options; $unique_values = array(); if (empty($text)) { return ''; } - foreach (array_filter(array_map('trim', explode($separator, $text))) as $item) { + foreach (array_filter(array_map('trim', explode($options['separator'], $text))) as $item) { $lowercase = drupal_strtolower($item); if (!in_array($lowercase, $lc_values)) { @@ -1252,11 +1345,11 @@ function nodewords_unique($text, $separa } } - if ($max_items > 0) { - $unique_values = array_slice($uniq_values, 0, $max_items); + if ($options['max_items'] > 0) { + $unique_values = array_slice($uniq_values, 0, $options['max_items']); } - return implode("$separator ", $unique_values); + return implode($options['separator'] . " ", $unique_values); } /***************************************************************************** @@ -1264,51 +1357,23 @@ function nodewords_unique($text, $separa ****************************************************************************/ /** - * Show the requirement errors reported from nodewords_requirements(). - * The function is an adaption of drupal_check_module(), and it is called in - * the module settings pages. - */ -function _nodewords_check_enabled_modules() { - if (user_access('administer site configuration')) { - if (!count(module_implements('nodewords_api'))) { - drupal_set_message( - t( - 'Nodewords does not create meta tags anymore; it is just a module that implements a public API used from the modules that create meta tags. You need to enable at least one module between nodewords_basic.module, nodewords_extra.module, and nodewords_verification_tags.module that are listed under Meta tags in the modules page.', - array('@url' => url('admin/build/modules')) - ), - 'error' - ); - } - - if (module_exists('nodewords_bypath')) { - drupal_set_message( - t( - 'The feature implemented inMeta Tags by Pathis now included in Nodewords; there is not need to use
Meta Tags by Path, and the module should be disabled to avoid possible conflicts. Disable the module in themodules page.', - array('@url' => url('admin/build/modules')) - ) - ); - } - } -} - -/** * Try to guess the $type and $id by looking at $_GET['q']. */ function _nodewords_detect_type_and_id() { $arg = arg(); if (variable_get('site_offline', 0) && !user_access('administer site configuration')) { - return array(NODEWORDS_MT_TYPE_NONE, 0); + return array(NODEWORDS_TYPE_NONE, ''); } $headers = drupal_get_headers(); if (preg_match('@HTTP/1\.[01]\x20+403@', $headers)) { - return array(NODEWORDS_MT_TYPE_ERRORPAGE, 403); + return array(NODEWORDS_TYPE_ERRORPAGE, 403); } if (preg_match('@HTTP/1\.[01]\x20+404@', $headers)) { - return array(NODEWORDS_MT_TYPE_ERRORPAGE, 404); + return array(NODEWORDS_TYPE_ERRORPAGE, 404); } $bool = ( @@ -1318,15 +1383,32 @@ function _nodewords_detect_type_and_id() ); if ($bool) { - return array('pager', 0); + return array(NODEWORDS_TYPE_PAGER, ''); } if (drupal_is_front_page() && variable_get('nodewords_use_frontpage_tags', TRUE)) { - return array(NODEWORDS_MT_TYPE_FRONTPAGE, 0); + return array(NODEWORDS_TYPE_FRONTPAGE, ''); + } + + foreach (_nodewords_get_pages_data() as $page) { + $path = $page->path; + + if (drupal_match_path($_GET['q'], $path)) { + return array(NODEWORDS_TYPE_PAGE, $path); + } + + $bool = ( + ($alias = drupal_get_path_alias($_GET['q'])) != $_GET['q'] && + drupal_match_path($alias, $path) + ); + + if ($bool) { + return array(NODEWORDS_TYPE_PAGE, $path); + } } if (!isset($arg[0])) { - return array(NODEWORDS_MT_TYPE_NONE, 0); + return array(NODEWORDS_TYPE_NONE, ''); } _nodewords_load_all_includes(); @@ -1334,18 +1416,12 @@ function _nodewords_detect_type_and_id() foreach (module_implements('nodewords_type_id') as $module) { $result = module_invoke($module, 'nodewords_type_id', $arg); - if (isset($result) && is_array($result) && count($result) > 2) { + if (isset($result) && is_array($result) && count($result) >= 2) { return $result; } } - foreach (_nodewords_get_pages_data() as $page) { - if (preg_match($page->regexp, $_GET['q'])) { - return array(NODEWORDS_MT_TYPE_PAGE, $page->path); - } - } - - return array(NODEWORDS_MT_TYPE_NONE, 0); + return array(NODEWORDS_TYPE_NONE, ''); } /** @@ -1363,8 +1439,7 @@ function _nodewords_get_pages_data($id = $result = db_query("SELECT * FROM {nodewords_custom} ORDER BY weight ASC"); while ($page = db_fetch_object($result)) { - $page->regexp = '/^('. preg_replace('/\\\\\*/', '.*', preg_quote($page->path, '/')) .')$/'; - $page->tags = nodewords_load_tags(NODEWORDS_MT_TYPE_PAGE, $page->path); + $page->tags = nodewords_load_tags(NODEWORDS_TYPE_PAGE, $page->path); $pages[$page->pid] = $page; } @@ -1391,11 +1466,11 @@ function _nodewords_load_all_includes() * Helper function for preg_match_callback(), called when replacing the tag img * in the teaser, when using it as meta tag DESCRIPTION content. */ -function _nodewords_teaser_match_callback($matches, $init = FALSE) { +function _nodewords_teaser_match_callback($matches) { static $bool; - if ($init) { - $bool = $matches; + if (!isset($bool)) { + $bool = variable_get('nodewords_use_alt_attribute', FALSE); } if ($bool && !empty($matches[1])) { Index: README.txt =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/nodewords/README.txt,v retrieving revision 1.30.2.2 diff -u -p -r1.30.2.2 README.txt --- README.txt 17 Nov 2009 05:25:34 -0000 1.30.2.2 +++ README.txt 30 Nov 2009 22:59:36 -0000 @@ -1,62 +1,112 @@ ; $Id: README.txt,v 1.30.2.2 2009/11/17 05:25:34 kiam Exp $ -This module allows you to set some meta tags for each node. - -Giving more attention to the important keywords and/or description on some of -your nodes allows you to get better search engine positioning (given that you -really only provide the keywords which exist in the node body itself, and do -not try to lie). +This module allows you to set some meta tags for the different resources exposed +by your site: nodes, users, views, taxonomy filters and error pages are some +examples. + +Giving more attention to the important keywords and/or description on your site +allows you to get better search engine positioning (given that you really only +provide the keywords which exist in the content itself, and do not try to lie). This version of the module only works with Drupal 6.x. Features ------------------------------------------------------------------------------ -Some features include: - -* The current supported meta tags are ABSTRACT, CANONICAL, COPYRIGHT, - GEO.POSITION, DESCRIPTION, ICBM, KEYWORDS, PICS-LABEL, REVISIT-AFTER, ROBOTS - and the site verification meta tags used by Google Webmaster Tools, - Microsoft Bing Webmaster Center, Yahoo! Site Explorer. - -* You can tell "nodewords" to add all terms of some specified vocabularies - to the KEYWORDS meta tag. - -* You can specify a default meta tag ROBOTS value to use for all pages. You can - override it on each page. - -* On taxonomy pages, the term description is used as the DESCRIPTION - tag. The term itself is added to the list of KEYWORDS. You can override - the description to use if you wish. +This is a brief of features provided by this module: * You can seperately specify the meta tags to show on some specific pages of - your site (in example, the front page, the error 403 page, the error 404 - page, the tracker page), or to use in specific situations (in example, when - the site is offline). - -* The support for Views, and Panels has been removed from Nodewords - 6.x-1.x on August 15, 2009; successive versions for Drupal 6 replaced it with - a more generic support for third-party module pages. - -* You can select which of these tags you want to output on each page. You - can also remove the edit box for these tags from the node edit page if - you don't like using it. + your site (the front page, the error 403 page, the error 404 page, the tracker + page), or to use in specific situations, when the site is offline for example. + +* A pluggable system allow the inclusion of new meta tags appart from the ones + provided by this module. + +* The current supported basic meta tags are ABSTRACT, CANONICAL, COPYRIGHT, + GEO.POSITION, DESCRIPTION, ICBM, KEYWORDS, PICS-LABEL, REVISIT-AFTER, ROBOTS. + These meta tags are provided by the module: nodewords_basic. + +* Additionally, you may include site verification meta tags used by external + sources: Google Webmaster Tools, Microsoft Bing Webmaster Center, Yahoo! Site + Explorer. + These meta tags are provided by the module: nodewords_verification. + +* Additionally you may include the Dublin Core meta tag schema. + These meta tags are provided by the module: nodewords_extra. + +* You can select which of the available tags will be available for edition, and + which will be exposed in the html of your site. + +* You can specify a default meta tag ROBOTS value used for all pages, but easily + overide it for every page. * All text of the DESCRIPTION and KEYWORDS meta tags are added to the search system so they are searable too; other meta tags could be added to the search system too (depending on the code implemented from the module). +Other modules integration +------------------------- +Nodewords integrates other modules for automatic selection of meta tags. + +* You can tell "nodewords" to add all terms of some specified vocabularies to + the KEYWORDS meta tag, integrating taxonomy vocabularies and nodewords. + +* On taxonomy pages, the term description is used as the DESCRIPTION tag. The + term itself is added to the list of KEYWORDS. You can override the description + to use if you wish. + +* Previous versions of this module provided support for Views and Panels. This + feature has been removed from Nodewords 6.x-1.x since August 15, 2009; as the + module provides an API allowing other modules to integrate with nodewords. + +* This module may also integrate taggadelic, cck, and other resources. + Installing Nodewords (aka Meta tags) (first time installation) ------------------------------------------------------------------------------ 1. Backup your database. -2. Copy the complete 'nodewords/' directory into the 'modules/' directory of - your Drupal site. +2. Copy the complete 'nodewords/' directory into the 'sites/all/modules/', + 'sites/default/modules' or 'sites/name_of_your_site/modules' folder of your + Drupal setup. More information about installing contributed modules could be + found at "Install contributed modules" (http://drupal.org/node/70151) 3. Enable the "Nodewords" module from the module administration page (Administer >> Site configuration >> Modules). 4. Configure the module (see "Configuration" below). +5. You should enable other modules providing meta tags. The nodewords module + includes three meta tags modules: + - nodewords basic: for typical DESCRIPTION, ABSTRACT, COPYRIGHT meta tags. + - nodewords extra: for Dublin meta tag Schema + - nodewords verification tags: for especific API meta tags by search engines. + +Updating Nodewords (aka Meta tags) (module version upgrade) +------------------------------------------------------------------------------ +1. Verify that the version you are going to upgrade contains all the features + your are using in your Drupal setup. Some features could have been removed + or replaced by others. + +2. Read carefully in the project issue tracking about upgrade paths problems + before you start the upgrade process. Some versions don't support a clean + upgrade path that may left your site meta tags unusable. + +3. Backup your database. + +4. Update current module code with latest recommended version. Previous versions + could have bugs already reported and fixed in the last version. + +4. Complete the update process, set maintenance mode, call the update.php script + and finish the update operation. For more information please go to: + http://groups.drupal.org/node/19513 + +4. Verify your module configuration and check that the features you are using + work as expected. Also verify that all required modules are enabled, and + permissions are set as desired. + +Note: whenever you have the chance, try an update in a local or development + copy of your site. + + Configuration ------------------------------------------------------------------------------ 1. On the access control administration page ("Administer >> User management @@ -72,76 +122,54 @@ Configuration All users will be able to see the assigned meta tags. -2. On the settings page ("Administer >> Content management >> - Nodewords") you can specify the default settings for the module. - Users need the "administer nodewords" permission to do this. - -3. The front page is an important page for each website. Therefor you can - specifically set the meta tags to use on the front page meta tags - settings page ("Administer >> Content management >> Nodewords >> - Front page"). - Users need the "administer nodewords" permission to do this. - - Alternatively, you can opt not to set the meta tags for the front page - on this page, but to use the meta tags of the view, panel or node the - front page points to. To do this, you need to uncheck the "Use front - page meta tags" option on the settings page. - - Note that, in contrast to previous versions of this module, the site - mission and/or site slogan are no longer used as DESCRIPTION or ABSTRACT - on the front page! - -4. You can completely disable the possibility to edit meta tags for each - individual content type by editing the content type workflow options +2. On the settings page ("Administer >> Content management >> Nodewords") you + can specify the default settings for the module. To access this page users + need the "administer nodewords" permission. + +3. You should enable meta tags for editing before they are available for use. + The same operation should be done for meta tag output. Only allowed Meta tags + are available for editing or exposed in the HTML of your site. + +4. The front page is an important page for each website. Therefor you can + specifically set the meta tags to use on the front page meta tags settings + page ("Administer >> Content management >> Nodewords >> Front page"). + Users need the "administer nodewords" permission to do this. When there are + resources providing meta tags promoted in the front page, you may Force the + usage of "Front page" meta tags superseeding all of them. + + Alternatively, you can opt not to set the meta tags for the front page on + this page, but to use the meta tags of the view, panel or node the front page + points to. To do this, you need to uncheck the "Use front page meta tags" + option on the settings page. + + Note that, in contrast to previous versions of this module, the site mission + and/or site slogan are no longer used as DESCRIPTION or ABSTRACT on the front + page! + +5. You can completely disable the possibility to edit meta tags for each + individual content type by editing the content type workflow options, by + default meta tags are enabled for all content types. ("Administer >> Content management >> Content types"). - Note that this will still output the default values for the meta tags. - -Using Nodewords and Tagadelic ------------------------------------------------------------------------------- -The Tagadelic module (http://drupal.org/project/tagadelic) allows one to -create a cloud of all terms used. The keywords you assign to nodes with -the Nodewords module will not appear in these clouds. + Note: this will still output the default values for the meta tags. -If you want to use tagclouds and have the same terms in the KEYWORDS meta -tag, you can configure nodewords as follows: - -1. Create a "Free tagging" vocabulary at "Administer >> Content management - >> Categories". For example, call this vocabulary "Keywords". - -2. On the meta tags settings page ("Administer >> Content management >> - Nodewords"), select the "Keywords" vocabulary as one of the "Auto-keywords - vocabularies". This will make sure that all terms you assign to nodes - will appear in the KEYWORDS meta tag. - -3. On the same page, deselect the checkbox "Keywords" in the "Tags to - show on edit form" fieldset. This will remove the meta tag KEYWORDS - input box on all node edit forms. The only way to assign KEYWORDS then - is to enter them in the vocabulary "Keywords" input box (which will - appear in the "Categories" box instead of the "Meta tags" one). - -The result is that the meta tag KEYWORDS will only contain the keywords -assigned to nodes by entering them in the free-tagging input box of the -"Keywords" vocabulary. Nodewords will add them to the KEYWORDS meta tag -and you can use a tagcloud to show all keywords too. - -Auto-generated meta DESCRIPTION for CCK content types ------------------------------------------------------------------------------- -It is recommended to use the contemplate (Content Template) module to -create a nicer looking node teaser that can also be used as auto-generated -DESCRIPTION. Bugs and shortcomings ------------------------------------------------------------------------------ -* See the list of issues at http://drupal.org/project/issues/nodewords. +* See the list of project issues[1]. Credits / Contact ------------------------------------------------------------------------------ -The original author of this module is Andras Barthazi. -Mike Carter (http://drupal.org/user/13164) and Gabor Hojtsy -(http://drupal.org/user/4166) provided some feature enhancements. -Robrecht Jacques (http://drupal.org/user/22598) is the current maintainer; -Alberto Paderno (http://drupal.org/user/55077) is the current co-maintainer. - -Best way to contact the authors is to submit a (support/feature/bug) issue at -the projects issue page at http://drupal.org/project/issues/nodewords. +Original author of this module is Andras Barthazi. Mike Carter[2] +and Gabor Hojtsy[3] +provided some feature enhancements. Robrecht Jacques[4] is current maintainer, +and Alberto Paderno[5] is the current co-maintainer. + +Best way to contact the authors is to submit a (support/feature/bug) issue in +the project issue queue at http://drupal.org/project/issues/nodewords. + +[1] http://drupal.org/project/issues/nodewords +[2] http://drupal.org/user/13164 +[3] http://drupal.org/user/4166 +[4] http://drupal.org/user/22598 +[5] http://drupal.org/user/55077