Description of the Change

This PR introducing new hooks to remote requests:

Hooks for Site Automation

sophi_request_args filter: Filters the arguments used in Sophi HTTP request.
sophi_request_result filter: Filters a Sophi HTTP request immediately after the response is received.

Used in: SophiWP\SiteAutomation\Request::request() and SophiWP\SiteAutomation\Auth::request_access_token()

Hooks for event tracker

sophi_tracking_data filter: Filters the data used in Sophi track event request.
sophi_tracking_result action: Fires after tracker sends the request.

Since the entire $data array is sent to Snowplow, looks it not safe to add new attributes to the array (f.e. for debugging). That's why we add the Snowplow\Tracker\Tracker $tracker object as a reference in both filters.

Used in: SophiWP\ContentSync\send_track_event()

sophi_tracker_emitter_debug filter: Allows to enable debug mode in the emitter to save responses and analyse them later.

Used in: SophiWP\ContentSync\init_tracker()

Closes #255

Possible Drawbacks

Checklist:

• I have read the CONTRIBUTING document.
• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my change.
• All new and existing tests passed.

Changelog Entry

Added - Filter sophi_request_args filters arguments used in Sophi HTTP request.
Added - Filter sophi_request_result filters a Sophi HTTP request immediately after the response is received.
Added - Filter sophi_tracking_data filters the data used in Sophi track event request.
Added - Action sophi_tracking_result fires after tracker sends the request.
Added - Filter sophi_tracker_emitter_debug allows to enable debug mode in the tracking emitter.

Credits

Props @cadic