ExternalAuditor sends content to external web service for auditing and judges the results returned by the external service.
ExternalAuditor is a convenient way to plug in a third party service (link a SEO ranking service or a spelling and grammar service) into Magnolia. An ExternalAuditor can be applied to different content types in Magnolia, for example a story defined in the Story app.
ExternalAuditor does the following:
- renders the selected content into a format suitable to the external service
- builds a request to the external service with the formatted content and any additional parameters
- sends a POST request to the external service and receives the results
- processes the results to determine if the audit is passed or judged as a error, warning or not
In addition to the common auditor properties, this auditor can be configured with the following properties:
A human-readable description of the configured auditor, suitable for use in auditor selection dialogs.
The name of the audit property where the audit results will be stored.
The location of the external web service. The url should be capable of receiving a POST request.
The request parameter for the content. If not defined, the contentKey will be "text".
Defines pre-set parameters to be include in the service request.
You can define additional static request parameters like license keys or client identifiers that will be added to the request.
A template definition for generating the content to be sent to the external service.
For more on template definitions, see Template definition.
A list of AuditDelegates (info.magnolia.services.seo.audit.impl.AuditDelegate) that interpret the results from the external service.
Here is an example from the SEO module. You can find this configuration here: