mirror of
https://github.com/silverstripe/silverstripe-externallinks.git
synced 2024-10-22 17:05:44 +02:00
58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
# External links
|
|
|
|
## Introduction
|
|
|
|
The external links module is a task and ModelAdmin to track and to report on broken external links.
|
|
|
|
## Maintainer Contact
|
|
|
|
* Kirk Mayo kirk (at) silverstripe (dot) com
|
|
|
|
## Requirements
|
|
|
|
* SilverStripe 3.0 +
|
|
|
|
## Features
|
|
|
|
* Add external links to broken links reports
|
|
* Add a task to track external broken links
|
|
|
|
## Installation
|
|
|
|
1. Download the module form GitHub (Composer support to be added)
|
|
2. Extract the file (if you are on windows try 7-zip for extracting tar.gz files
|
|
3. Make sure the folder after being extracted is named 'externallinks'
|
|
4. Place this directory in your sites root directory. This is the one with framework and cms in it.
|
|
5. Run in your browser - `/dev/build` to rebuild the database.
|
|
6. Run the following task *http://path.to.silverstripe/dev/tasks/CheckExternalLinks* to check for broken external links
|
|
|
|
## Report ##
|
|
|
|
A new report is added called 'External Broken links report' from here you can also start a new job which is run
|
|
via AJAX and in batches of 10 so it can be run via content editors who do not have access to jobs or tasks.
|
|
|
|
## Dev task ##
|
|
|
|
Run the following task *http://path.to.silverstripe/dev/tasks/CheckExternalLinks* to check your site for external
|
|
broken links.
|
|
|
|
## Queued job ##
|
|
|
|
If you have the queuedjobs module installed you can set the task to be run every so ofter
|
|
Add the following yml config to config.yml in mysite/_config have the the task run once every day (86400 seconds)
|
|
|
|
CheckExternalLinks:
|
|
Delay: 86400
|
|
|
|
## Whitelisting codes ##
|
|
|
|
If you want to ignore or whitelist certain http codes this can be setup via IgnoreCodes in the config.yml
|
|
file in mysite/_config
|
|
|
|
CheckExternalLinks:
|
|
Delay: 60
|
|
IgnoreCodes:
|
|
- 401
|
|
- 403
|
|
- 501
|