portrino / codeception-yandex-module
Provides validation of structured data via yandex API
Requires
- codeception/codeception: ~2.3
- flow/jsonpath: ~0.3
- nixsolutions/yandex-php-library: ~3.0.0
Requires (Dev)
- phpstan/phpstan: ^0.8
- phpunit/phpunit: ~6.4
- squizlabs/php_codesniffer: ~3.0.2
README
This package provides validation of responses via Structured data validator API from Yandex. You can automatically check if your embedded structured data markup (aka semantic markup) is correct based on the current vocabularies like schema.org.
To transmit data to the API, you specify the HTML code or URL of the page. After completing validation, the API outputs the structured data extracted from the page in JSON format, > along with the codes of any errors detected. The following syntaxes are currently supported: JSON-LD, RDFa, microdata, and microformats.
Source: https://tech.yandex.com/validator/
With this module you are able to automate tests for semantic data validation in your cests via codeception. You save time during development of new features, because you do not have to copy your markup manually into the structured data testing tool or structured data validator when checking if some new feature or bugfix break your semantic markup.
You also can use this module for automating structured data validation for large quantities of pages.
Installation
You need to add the repository into your composer.json file
composer require --dev portrino/codeception-yandex-module
Usage
You can use this module as any other Codeception module, by adding 'Yandex' to the enabled modules in your Codeception suite configurations.
Enable module and setup the configuration variables
- After registering you can get the
apiKey
here: https://developer.tech.yandex.ru/ - The
url
could be set in config file directly or via an environment variable:%BASE_URL%
modules: enabled: - Yandex: depends: PhpBrowser url: ADD_YOUR_BASE_URL_HERE apiKey: ADD_YOUR_API_KEY_HERE
Update Codeception build
codecept build
Implement the cept / cest
$I->wantToTest('If structured data for page is valid.'); $I->amOnPage('foo/bar/'); $I->seeResponseCodeIs(\Codeception\Util\HttpCode::OK); // 200 // validate all $I->seeResponseContainsValidStructuredDataMarkup(); // validate only JSON+LD $I->seeResponseContainsValidJsonLdMarkup(); // validate only Microdata $I->seeResponseContainsValidMicrodataMarkup(); // validate only Microformat $I->seeResponseContainsValidMicroformatMarkup(); // validate only Rdfa $I->seeResponseContainsValidRdfaMarkup(); // grab the data array from Yandex API response // @see: https://tech.yandex.com/validator/doc/dg/concepts/response_standart-docpage/ $data = $I->grabStructuredDataFromApiResponse()['json-ld']; // grab the data from Yandex API response via jsonPath // !Important: All chars like . // / and - are replaced by _ to make jsonPath working! $I->assertEquals( 'foo.com', $I->grabStructuredDataFromApiResponseByJsonPath('json_ld.0.http___schema_org_name.0._value')[0] );
Methods
seeResponseContainsValidStructuredDataMarkup()
Validates the current response from $I->amOnPage('/foo/bar/');
against the structured data validator API and checks
all supported formats like: JSON-LD, RDFa, microdata, and microformats.
$I->seeResponseContainsValidStructuredDataMarkup();
seeResponseContainsValidJsonLdMarkup()
Validates the current response from $I->amOnPage('/foo/bar/');
against the structured data validator API and checks
only the data which is in JSON-LD format.
$I->seeResponseContainsValidJsonLdMarkup();
seeResponseContainsValidMicrodataMarkup()
Validates the current response from $I->amOnPage('/foo/bar/');
against the structured data validator API and checks
only the data which is in microdata format.
$I->seeResponseContainsValidMicrodataMarkup();
seeResponseContainsValidMicroformatMarkup()
Validates the current response from $I->amOnPage('/foo/bar/');
against the structured data validator API and checks
only the data which is in microformat format.
$I->seeResponseContainsValidMicroformatMarkup();
seeResponseContainsValidRdfaMarkup()
Validates the current response from $I->amOnPage('/foo/bar/');
against the structured data validator API and checks
only the data which is in RDFa format.
$I->seeResponseContainsValidRdfaMarkup();
grabStructuredDataFromApiResponse()
Grab the structured data from the current response and it returns it as array. Please have a look at https://tech.yandex.com/validator/doc/dg/concepts/response_standart-docpage/ for information about the standard response format of the yandex API.
$data = $I->grabStructuredDataFromApiResponse();
grabStructuredDataFromApiResponseByJsonPath()
Experimental!!!
Grab the structured data from the current response by jsonPath query syntax with the help of JSONPath PHP Package. All "special" chars like:
- .
- //
- /
-
- :
- @
- '
- \
are replaced in json response from yandex structured data validator API by _ to make jsonPath working!
$data = $I->grabStructuredDataFromApiResponseByJsonPath('json_ld.0.http___schema_org_name.0._value');
Authors
- André Wuttig - Initial work, Unit Tests - aWuttig
See also the list of contributors who participated in this project.