Über df_tools

If you need a way to automatically check links in your installation, perform automated redirection tests or compare the current content status from different pages with a previously saved one, then the extension "df_tools" is the right choice for you. This was created in cooperation with our customer domainFACTORY.

"Forwarding" function

With the "Forwarding" function you can check whether one or more specified forwardings point to the correct page and which HTTP status code they return.  Here is an example: Figure 1 shows four links "/features.html", "/test 2", "/test 3" and "/test 4". Since the redirection from "/features.html" to "/features.html" actually exists, the redirection has the code 200 for OK. "/test 2" does not exist, so this forwarding has the code 404 Not Found. With"/test 3" the selected code 200 does not apply, since the forwarding"/test 3" does not exist and thus the code 404 is returned. Furthermore, you can test whether the links provided are correct. With"/test 4" this is the case, since the final URL does not correspond to"/test 5" and therefore the entry is red (= error). You can also view the exact error message by moving the mouse over the status symbol. This applies to all other functions in the same way.

Actions: 
Pencil: Edit Forwarding
Gear: To start the tests
Garbage can: Delete the forwarding

Status:
Red exclamation mark: Error
Yellow triangle: Warning
Green hook: Everything ok

"Links" function

The function "Links" can be compared a little with "Forwarding". However, instead of testing the selected URL, the function checks whether these work and delivers the HTTP status code 200 when called.

The "Errors" group shown in Figure 2 contains tests which, for example, are delivered with a 404 error or are otherwise unavailable. The group Warnings contains URLs which have been redirected after the call, e.g. typo3.org is redirected to typo3.org. Nevertheless, both variants are fully functional.

Status:
Red exclamation mark: Error
Yellow triangle: Warning
Green hook: Everything ok 

Actions: 
Gear: To start the tests
Question mark/exclamation point: Set the entry to false-positive, for example, to mark a warning as "OK
Light bulb: The entry can be ignored via the light bulb (useful for incorrectly marked links)

"Backlinks" function

Under the function "Backlinks" you can check if one page is linked to another. As you can see in Figure 3, "http://typo3.org/donate/online-donation/" is linked to our example page, but "http://www.google.com" is not.

Status:
Red exclamation point: Error
Yellow triangle: Warning
Green hook: Everything ok

Actions:
Pencil: edit forwarding
Gear: To start the tests
Dustbin: Delete backlink
Speech Bubble: Comment entry

"Content comparison" function

"Content comparison" function
Here you can compare the contents of two pages. Figure 4 shows that /features.html and /customizing.html are not identical, but /features.html and /features.html are. If the same URL is stored under "Test" and "Comparison", the content of a previously saved version is compared with the current variant.

Status:
Red exclamation mark: Error
Yellow triangle: Warning
Green hook: Everything ok   

Actions: 
Pencil: Edit entry
Gear: To start the tests
Waste bin: Delete content comparison
Green arrows: Use the green arrows to update the content

Configuration

You can access the configuration by searching for "df_tools" in the extension manager. As can be seen in Figure 5, the cogwheel is located on the right side under "Actions" to get to the configuration. A click on the extension name also leads there.

The following options are available:

Storage Location for Records[basic.storagePid]
Here you can select the storage location of the data records per page ID

Excluded tables (only link checker, comma-separated)[basic.excludedTables]
As the name suggests, you can exclude or include tables in the "Links" test here.

Excluded table fields (only link checker, comma-separated, e.g. tx_table<field>)
Similar to "Excluded tables", you can exclude special table fields under this configuration item

Timeout Limit for the URL Checker[basic.cUrlTimeoutLimit]
Enter the timeout limit for the URL checker here. If this is reached, the URL checker terminates prematurely for the URL currently being tested and records the test as an error.

Below are the standard entries in the "Excluded Tables" line:

tx_dftools_domain_model_redirecttest,
tx_dftools_domain_model_linkcheck,
tx_dftools_domain_model_contentcomparisontest,
tx_dftools_domain_model_backlinktest,sys_log,
tx_extensionmanager_domain_model_extension,sys_history,
tx_extensionmanager_domain_model_repository