function linkchecker_admin_settings_form in Link checker 5.2
Same name and namespace in other branches
- 6.2 includes/linkchecker.admin.inc \linkchecker_admin_settings_form()
- 7 linkchecker.admin.inc \linkchecker_admin_settings_form()
1 string reference to 'linkchecker_admin_settings_form'
- linkchecker_menu in ./linkchecker.module
- Implementation of hook_menu().
File
- ./linkchecker.module, line 117
- This module periodically check links in given node types, blocks, cck fields, etc.
Code
function linkchecker_admin_settings_form() {
$form['settings'] = array(
'#type' => 'fieldset',
'#title' => t('General settings'),
'#collapsible' => FALSE,
);
$form['settings']['linkchecker_scan_nodetypes'] = array(
'#type' => 'checkboxes',
'#title' => t('Scan node types for links'),
'#default_value' => variable_get('linkchecker_scan_nodetypes', array()),
'#options' => array_map('check_plain', node_get_types('names')),
'#description' => t('Enable link checking for the selected node type(s).'),
);
$comment_dependencies = '<div class="admin-dependencies">';
$comment_dependencies .= t('Depends on: !dependencies', array(
'!dependencies' => module_exists('comment') ? t('@module (<span class="admin-enabled">enabled</span>)', array(
'@module' => 'Comment',
)) : t('@module (<span class="admin-disabled">disabled</span>)', array(
'@module' => 'Comment',
)),
));
$comment_dependencies .= '</div>';
$form['settings']['linkchecker_scan_comments'] = array(
'#default_value' => variable_get('linkchecker_scan_comments', 0),
'#type' => 'checkbox',
'#title' => t('Scan comments for links'),
'#description' => t('Enable this checkbox if links in comments of the above selected node type(s) should be checked.') . $comment_dependencies,
'#disabled' => module_exists('comment') ? FALSE : TRUE,
);
$form['settings']['linkchecker_scan_blocks'] = array(
'#default_value' => variable_get('linkchecker_scan_blocks', 0),
'#type' => 'checkbox',
'#title' => t('Scan blocks for links'),
'#description' => t('Enable this checkbox if links in blocks should be checked.'),
);
$form['settings']['linkchecker_fqdn_only'] = array(
'#default_value' => variable_get('linkchecker_fqdn_only', 1),
'#type' => 'checkbox',
'#title' => t('Check full qualified domain names only'),
'#description' => t('Enable this checkbox if only full qualified URLs (http://example.com/foo/bar) should be checked. If unchecked, all internal (/node/123) and external (http://example.com/foo/bar) URLs will be checked.'),
);
$form['tag'] = array(
'#type' => 'fieldset',
'#title' => t('Link extraction'),
'#collapsible' => FALSE,
);
$form['tag']['linkchecker_extract_from_a'] = array(
'#default_value' => variable_get('linkchecker_extract_from_a', 1),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><a></code> and <code><area></code> tags'),
'#description' => t('Enable this checkbox if normal hyperlinks should be extracted. The anchor element defines a hyperlink, the named target destination for a hyperlink, or both. The area element defines a hot-spot region on an image, and associates it with a hypertext link.'),
);
$form['tag']['linkchecker_extract_from_audio'] = array(
'#default_value' => variable_get('linkchecker_extract_from_audio', 0),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><audio></code> tags'),
'#description' => t('Enable this checkbox if links in audio tags should be extracted. The audio element is used to embed sound content.'),
);
$form['tag']['linkchecker_extract_from_embed'] = array(
'#default_value' => variable_get('linkchecker_extract_from_embed', 0),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><embed></code> tags'),
'#description' => t('Enable this checkbox if links in embed tags should be extracted. This is an obsolete and non-standard element that was used for embedding plugins in past and should no longer used in modern websites.'),
);
$form['tag']['linkchecker_extract_from_iframe'] = array(
'#default_value' => variable_get('linkchecker_extract_from_iframe', 0),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><iframe></code> tags'),
'#description' => t('Enable this checkbox if links in iframe tags should be extracted. The iframe element is used to embed another HTML page into a page.'),
);
$form['tag']['linkchecker_extract_from_img'] = array(
'#default_value' => variable_get('linkchecker_extract_from_img', 0),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><img></code> tags'),
'#description' => t('Enable this checkbox if links in image tags should be extracted. The img element is used to add images to the content.'),
);
$form['tag']['linkchecker_extract_from_object'] = array(
'#default_value' => variable_get('linkchecker_extract_from_object', 0),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><object></code> and <code><param></code> tags'),
'#description' => t('Enable this checkbox if multimedia and other links in object and their param tags should be extracted. The object tag is used for flash, java, quicktime and other applets.'),
);
$form['tag']['linkchecker_extract_from_source'] = array(
'#default_value' => variable_get('linkchecker_extract_from_source', 0),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><source></code> tags'),
'#description' => t('Enable this checkbox if links in source tags should be extracted. The source element is used to specify multiple media resources for audio and video elements.'),
);
$form['tag']['linkchecker_extract_from_video'] = array(
'#default_value' => variable_get('linkchecker_extract_from_video', 0),
'#type' => 'checkbox',
'#title' => t('Extract links in <code><video></code> tags'),
'#description' => t('Enable this checkbox if links in video tags should be extracted. The video element is used in to embed video content.'),
);
$filters = filter_list_all();
$filter_options = array();
foreach ($filters as $filter) {
$filter_options[$filter->module . '/' . $filter->delta] = $filter->name;
}
$form['tag']['linkchecker_filter_blacklist'] = array(
'#type' => 'checkboxes',
'#title' => t('Filters disabled for link extraction'),
'#default_value' => variable_get('linkchecker_filter_blacklist', explode('|', LINKCHECKER_DEFAULT_FILTER_BLACKLIST)),
'#options' => $filter_options,
'#description' => t('If a filter has been enabled for an input format it runs first and afterwards the link extraction. This helps the link checker module to find all links normally created by custom filters (e.g. Markdown filter, Bbcode). All filters used as an inline references (e.g. Weblink filter <code>[link: id]</code>) to other content and filters only wasting processing time (e.g. Line break converter) should be disabled. This setting does not have any effect on how content is shown on a page. This feature optimizes the internal link extraction process for link checker and prevents false alarms about broken links in content not having the real data of a link.'),
);
$form['check'] = array(
'#type' => 'fieldset',
'#title' => t('Check settings'),
'#collapsible' => FALSE,
);
$form['check']['linkchecker_check_useragent'] = array(
'#type' => 'select',
'#title' => t('User-Agent'),
'#description' => t('Defines the user agent that will be used for checking links on remote sites. If someone blocks the standard Drupal user agent you can try with a more common browser.'),
'#default_value' => variable_get('linkchecker_check_useragent', 'Drupal (+http://drupal.org/)'),
'#options' => array(
'Drupal (+http://drupal.org/)' => 'Drupal (+http://drupal.org/)',
'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1;)' => 'Windows XP / Internet Explorer 7.0',
'Mozilla/5.0 (Windows; U; Windows NT 5.1; de; rv:1.9.0.5) Gecko/2008120122 Firefox/3.0.5' => 'Windows XP / Mozilla Firefox 3.0.5',
'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0;)' => 'Windows Vista / Internet Explorer 7.0',
'Mozilla/5.0 (Windows; U; Windows NT 6.0; de; rv:1.9.0.5) Gecko/2008120122 Firefox/3.0.5' => 'Windows Vista / Mozilla Firefox 3.0.5',
),
);
$form['check']['linkchecker_check_links_interval'] = array(
'#type' => 'select',
'#title' => t('Check interval for links'),
'#description' => t('This interval setting defines how often cron will re-check the status of links.'),
'#default_value' => variable_get('linkchecker_check_links_interval', 2419200),
'#options' => drupal_map_assoc(array(
86400,
172800,
259200,
604800,
1209600,
2419200,
4838400,
), 'format_interval'),
);
$form['check']['linkchecker_disable_link_check_for_urls'] = array(
'#default_value' => variable_get('linkchecker_disable_link_check_for_urls', LINKCHECKER_RESERVED_DOCUMENTATION_DOMAINS),
'#type' => 'textarea',
'#title' => t('Do not check the link status of links containing these URLs'),
'#description' => t('By default this list contains the domain names reserved for use in documentation and not available for registration. See <a href="@rfc-2606">RFC 2606</a>, Section 3 for more information. URLs on this list are still extracted, but the link setting <em>Check link status</em> becomes automatically disabled to prevent false alarms. If you change this list you need to clear all link data and re-analyze your content. Otherwise this setting will only affect new links added after the configuration change.', array(
'@rfc-2606' => 'http://www.rfc-editor.org/rfc/rfc2606.txt',
)),
'#wysiwyg' => FALSE,
);
$form['error'] = array(
'#type' => 'fieldset',
'#title' => t('Error handling'),
'#description' => t('Defines error handling and custom actions to be executed if specific HTTP requests are failing.'),
'#collapsible' => FALSE,
);
$form['error']['linkchecker_action_status_code_301'] = array(
'#title' => t('Update permanently moved links'),
'#description' => t('If enabled, outdated links in content providing a status <em>Moved Permanently</em> (status code 301) are automatically updated to the most recent URL. If used, it is recommended to use a value of <em>three</em> to make sure this is not only a temporarily change. This feature trust sites to provide a valid permanent redirect. A new node revision is automatically created on link updates if <em>create new revision</em> is enabled in the <a href="@node_types">node type</a> workflow settings. It is recommended to create new revisions for all link checker enabled node types. Link updates are nevertheless always logged in <a href="@dblog">recent log entries</a>.', array(
'@dblog' => url('admin/logs/watchdog'),
'@node_types' => url('admin/content/types'),
)),
'#type' => 'select',
'#default_value' => variable_get('linkchecker_action_status_code_301', 0),
'#options' => array(
0 => t('Disabled'),
1 => t('After one failed check'),
2 => t('After two failed checks'),
3 => t('After three failed checks'),
5 => t('After five failed checks'),
10 => t('After ten failed checks'),
),
);
$form['error']['linkchecker_action_status_code_404'] = array(
'#title' => t('Unpublish node on file not found error'),
'#description' => t('If enabled, a node with one or more broken links (status code 404) will be unpublished and moved to moderation queue for review after the number of specified fails. If used, it is recommended to use a value of <em>three</em> to make sure this is not only a temporarily error.'),
'#type' => 'select',
'#default_value' => variable_get('linkchecker_action_status_code_404', 0),
'#options' => array(
0 => t('Disabled'),
1 => t('After one file not found error'),
2 => t('After two file not found errors'),
3 => t('After three file not found errors'),
5 => t('After five file not found errors'),
10 => t('After ten file not found errors'),
),
);
$form['error']['linkchecker_ignore_response_codes'] = array(
'#default_value' => variable_get('linkchecker_ignore_response_codes', "200\n302\n304\n401\n403"),
'#type' => 'textarea',
'#title' => t("Don't treat these response codes as errors"),
'#description' => t('One HTTP status code per line, e.g. 403.'),
'#wysiwyg' => FALSE,
);
$description = '<p>' . t('These actions will either clear all link checker tables in the database and/or analyze all selected node types, blocks and cck fields (see settings above) for new/updated/removed links. Normally there is no need to press one of these buttons. Use this only for immediate cleanup tasks and to force a full re-build of the links to be checked in the linkchecker tables. Keep in mind that all custom link settings will be lost!') . '</p>';
$description .= '<p>' . t('<strong>Note</strong>: These functions ONLY collect the links, they do not evaluate the HTTP response codes, this will be done during normal cron runs.') . '</p>';
$form['clear'] = array(
'#type' => 'fieldset',
'#title' => t('Clear link data'),
'#description' => $description,
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$form['clear']['linkchecker_analyze'] = array(
'#type' => 'submit',
'#value' => t('Analyze content for links'),
);
$form['clear']['linkchecker_clear_analyze'] = array(
'#type' => 'submit',
'#value' => t('Clear link data and analyze content for links'),
);
return system_settings_form($form);
}
