padosoft / laravel-google-structured-data-testing-tool
Laravel Laravel Package for testing Schema.org markup or other structured data formats with google structured data testing tool undocumented API.
Installs: 208
Dependents: 0
Suggesters: 0
Security: 0
Stars: 37
Watchers: 4
Forks: 12
Open Issues: 1
Requires
- php: >=7.0.0
- illuminate/console: ~5.0
- illuminate/support: ^5.0
- padosoft/support: ^1.9
- tightenco/mailthief: 0.*
Requires (Dev)
- mockery/mockery: ^0.9.5
- orchestra/testbench: ^3.2
- padosoft/laravel-test: ^2.0
- padosoft/test: ^0.2
- phpunit/phpunit: ^5.0
This package is auto-updated.
Last update: 2024-12-22 11:42:45 UTC
README
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.
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.
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:
$ composer require padosoft/laravel-google-structured-data-testing-tool
You must install this service provider.
// 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.
You can publish the config file of this package with this command:
php artisan vendor:publish --provider="Padosoft\Laravel\Google\StructuredDataTestingTool\GoogleStructuredDataTestToolServiceProvider"
The following config file will be published in config/laravel-google-structured-data-testing-tool.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.
USAGE
When the installation is done you can easily run command to print help:
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
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!
By default, the command displays the result in console, but you can also
send an html email by using the --mail
option:
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:
php artisan google-markup:test https://www.padosoft.com
Here is an example to send output report to mail:
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):
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
:
// 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:
OUTPUT CONSOLE BULK CHECK WITH ERRORS:
Change log
Please see CHANGELOG for more information what has changed recently.
Testing
$ composer test
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email instead of using the issue tracker.
Credits
About Padosoft
Padosoft (https://www.padosoft.com) is a software house based in Florence, Italy. Specialized in E-commerce and web sites.
License
The MIT License (MIT). Please see License File for more information.