, (*1)
This package provides a series of commands to automate and bulk check of Schema.org markup or other structured data formats with google structured data testing tool undocumented API that I found.
Google already provides a good tool for testing markup data using the Search Console in Webmaster Tools.
But how can I test markup data if you want to programmatically test your web site urls or a bulk set of urls?
You can't do this with google wmt.
This package try to resolve these problems., (*2)
WARNING
Note: This is an undocumented Google API. I found it when I interacted with Google’s Structured Data Testing Tool and Google Chrome debug console,
thus there is no warranty that the API remains public or that the API changes make the package unusable., (*3)
Table of Contents
Requires
- php: >=7.0.0
- illuminate/support: ^5.0
- illuminate/http: ^5.0
- padosoft/support": ^1.9
Installation
You can install the package via composer:
``` bash
$ composer require padosoft/laravel-google-structured-data-testing-tool, (*4)
You must install this service provider.
``` php
// config/app.php
'provider' => [
...
Padosoft\Laravel\Google\StructuredDataTestingTool\GoogleStructuredDataTestToolServiceProvider::class,
...
];
You don't need to register the command in app/Console/Kernel.php, because it provides by GoogleStructuredDataTestToolServiceProvider register() method., (*5)
You can publish the config file of this package with this command:
``` bash
php artisan vendor:publish --provider="Padosoft\Laravel\Google\StructuredDataTestingTool\GoogleStructuredDataTestToolServiceProvider", (*6)
The following config file will be published in `config/laravel-google-structured-data-testing-tool.php`
``` php
return array(
'mailSubjectSuccess' => env(
'STRUCTURED_DATA_TESTING_TOOL_SUBJECT_SUCCESS',
'[google-structured-data-testing-tool]: Ok - markup data is ok.'
),
'mailSubjetcAlarm' => env(
'STRUCTURED_DATA_TESTING_TOOL_SUBJECT_ALARM',
'[google-structured-data-testing-tool]: Alarm - markup data error detected.'
),
'mailFrom' => env('STRUCTURED_DATA_TESTING_TOOL_MESSAGE_FROM', 'info@example.com'),
'mailFromName' => env('STRUCTURED_DATA_TESTING_TOOL_MESSAGE_FROM_NAME', 'Info Example'),
'mailViewName' => env('STRUCTURED_DATA_TESTING_TOOL_MAIL_VIEW_NAME', 'laravel-google-structured-data-testing-tool::mail'),
'logFilePath' => env('STRUCTURED_DATA_TESTING_TOOL_LOG_FILE_PATH', storage_path() . '/logs/laravel-google-structured-data-testing-tool.log')
);
In your app config folder you can copy from src/config/.env.example the settings for yours .env file used in laravel-google-structured-data-testing-tool.php.
If you use mathiasgrimm/laravel-env-validator
in src/config folder you'll find an example for validate the env settings., (*7)
USAGE
When the installation is done you can easily run command to print help:, (*8)
php artisan google-markup:test https://www.padosoft.com
The google-markup:test command check the structured data and schema.org markup in the given site https://www.padosoft.com, (*9)
You can also pass the path of url txt (a file with one url per line) as an argument:
php google-markup:test /path/to/my/url.txt
so you can check multiple site/url (bulk) in one command!, (*10)
By default, the command displays the result in console, but you can also
send an html email by using the --mailoption:, (*11)
php google-markup:test https://www.padosoft.com --mail=mymail@mydomain.me
EXAMPLE:
Here is a basic example to check composer.lock into these dir:, (*12)
php artisan google-markup:test https://www.padosoft.com
Here is an example to send output report to mail:, (*13)
php artisan google-markup:test https://www.padosoft.com --mail=mymail@mydomain
Here is an example to ignore two urls for markup error (if command found any markup error into these dir, write it into output but the email subject isn't set to ALERT):, (*14)
php artisan google-markup:test /path/to/my/url.txt --mail=mymail@mydomain --whitelist="https://www.padosoft.com,https://blog.padosoft.it"
SCHEDULE COMMAND
You can schedule a daily (or weekly etc..) report easly, by adding this line into schedule method in app/Console/Kernel.php :, (*15)
// app/console/Kernel.php
protected function schedule(Schedule $schedule)
{
...
$schedule->command('google-markup:test "/path/to/my/url.txt" --mail=mymail@mydomain')
->daily()
->withoutOverlapping()
->sendOutputTo(Config::get('laravel-google-structured-data-testing-tool.logFilePath'));
}
SCREENSHOOTS
OUTPUT CONSOLE WITH ONE URL TEST:
, (*16)
OUTPUT CONSOLE BULK CHECK OK:
, (*17)
OUTPUT CONSOLE BULK CHECK WITH ERRORS:
, (*18)
EMAIL VIEW:
, (*19)
EMAIL VIEW WITH ERRORS:
, (*20)
Change log
Please see CHANGELOG for more information what has changed recently., (*21)
Testing
bash
$ composer test, (*22)
Contributing
Please see CONTRIBUTING for details., (*23)
Security
If you discover any security related issues, please email instead of using the issue tracker., (*24)
Credits
About Padosoft
Padosoft (https://www.padosoft.com) is a software house based in Florence, Italy. Specialized in E-commerce and web sites., (*25)
License
The MIT License (MIT). Please see License File for more information., (*26)
Wallogit.com
