www.aleph1.co.uk Git - yaffs-website/blob - web/modules/contrib/linkchecker/README.txt

   1
   2 Link Checker
   3 ------------
   4
   5 Installation:
   6
   7 1. Install linkchecker via Modules page.
   8 2. Go to Modules and enable the "Link checker" module.
   9 3. Go to Configuration -> Content authoring -> Link checker and enable the node types to scan.
  10 4. Under "Link extraction" check all HTML tags that should be scanned.
  11 5. Adjust the other settings if the defaults don't suit your needs.
  12 6. Save configuration
  13 7. Wait for cron to check all your links... this may take some time! :-)
  14
  15 If links are broken they appear under Reports -> Broken links.
  16
  17 If not, make sure cron is configured and running properly on your Drupal
  18 installation. The Link checker module also logs somewhat useful info about it's
  19 activity under Reports -> Recent log messages.
  20
  21
  22 Required:
  23
  24 1. For internal URL extraction you need to make sure that Cron always get called
  25    with your real public site URL (for e.g. http://example.com/cron.php). Make
  26    sure it's never executed with http://localhost/cron.php or any other
  27    hostnames or ports, not available from public. Otherwise all links may be
  28    reported as broken and cannot verified as they should be.
  29
  30    To make sure it always works - it's required to configure the $base_url in
  31    the sites settings.php with your public sites URL. Better safe than sorry!
  32
  33
  34 Known issues:
  35
  36 There are a lot of known issues in drupal_http_request(). These have been solved
  37 in HTTPRL. As a workaround it's recommended to use HTTPRL in linkchecker.
  38
  39 Issues list:
  40
  41 * #997648: drupal_http_request() always calls fread() one more time than necessary
  42 * #164365-12: drupal_http_request() does handle (invalid) non-absolute redirects
  43 * #205969-11: drupal_http_request() assumes presence of Reason-Phrase in response Status-Line
  44 * #371495: Error message from drupal_http_request() not UTF8 encoded
  45 * #193073-11: drupal_http_request - socket not initialized
  46 * #106506-8: drupal_http_request() does not handle 'chunked' responses - Make it support HTTP 1.1
  47 * #1096890-15: drupal_http_request should return error if reaches max allowed redirects
  48 * #875342-21: drupal_http_request() should pick up X-Drupal-Assertion-* HTTP headers
  49 * #965078-31: HTTP request checking is unreliable and should be removed in favor of watchdog() calls
  50 * #336367: HTTP client should protect commas when folding (compatibility with legacy HTTP/1.0)
  51 * #45338: log fsockopen errors to watchdog