DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Ext: df_tools¶

License: GNU GPL, Version 2

Repository: https://gitlab.sgalinski.de/typo3/df_tools

Please report bugs here: https://gitlab.sgalinski.de/typo3/df_tools

TYPO3 version: >7.6

About¶

This extension provides some useful tools for testing your internal redirects, links on your site, backlinks on other sites and to compare content of two different URLs or the same URL with a previously saved state. You manage the whole application with the backend module in the admin section.

Furthermore you can schedule the tests with the Scheduler extension.

Installation¶

Install the extension with the extension manager
Add the static template of the extension to your template of your root page or you extension root templates

Configuration¶

In the Extension Manager you have various options to configure the Module:

Record Storage Page¶

If you want to store the test records on a specific page/system folder, you can provde a page id here.

Excluded Tables¶

A comma seperated list of tables that the Linkchecker should ignore, when searching for URLs.

Exclude Table Fields¶

A comma seperated list of table columns that the Linkchecker should ignore, when searching for URLs. You need to use the format table here.

Timeout limit¶

The maximum time the URL checker should spend before failing the request.

The backend module¶

All the parts of the backend module are used in a similar way (the Test Links section behaves slightly different):

You can add and run new tests with the appropriate buttons. By double clicking a row, you can edit the fields of the selected test. Each row has an icon to delete, edit or refresh the entry. For additional help you can uncollapse the Help section at the top.

The module consists of 4 parts:

Test Redirects¶

This tool can be used to test redirects of different kinds. You can automatically start it by creating a scheduler job.

When adding a test you need to specify the Test URL and the Expected URL. Also you should add the expected HTTP Code (default is 200)

Test Links¶

You can use the tool to find and test all link checks on your site. The results are ordered by http result code and the matching of the URLs. Also this job can be triggered by an scheduler job.

With the Synchronize Data you update the tests to contain all the links from your site. You need to do this, whenever you add a new link to the site. Double clicking a row will open a new window with the given URL of that row loaded in it.

Test Back Links¶

This tool checks if a configured url contains a backlink to your domain. The task can be executed as a scheduler job too.

Again you can add a Test URL and an Expected URL.

Test Content Comparison¶

If you ever need to compare the content of two pages, then you should use this function. You just need to enter two urls to start the comparison of the contents. Of course you can trigger this job by using a scheduler job.

Adding a Scheduler Task¶

If you want to regularly run your tests, you should setup task with the TYPO3 Scheduler extension.

df_tools comes with multiple CommandController tasks:

RedirectTest: runAllTests¶

This task will run all configured redirect tests as configured in the backend module.

RedirectTest: importFromRealUrl¶

Creates redirect tests from realurl redirect entries.

ContentComparisonTest: runAllTests¶

This task will run all configured content comparison tests as configured in the backend module.

ContentComparisonTest: synchronize¶

Synchronizes the contents of the content comparison test urls.

BacklinkTest: runAllTests¶

This task will run all configured backlink tests as configured in the backend module.

LinkCheck: runAllTests¶

This task will run all configured link check tests as configured in the backend module.

LinkCheck: synchronize¶

Synchronizes the current data with the external urls on the page.