https://github.com/Automattic/republication-tracker-tool

Provides a Creative Commons sharing button and tracking mechanism that integrates with Google Analytics to track republished articles from external websites.
https://github.com/Automattic/republication-tracker-tool

wordpress-plugin

Last synced: 7 days ago
JSON representation

Provides a Creative Commons sharing button and tracking mechanism that integrates with Google Analytics to track republished articles from external websites.

• Host: GitHub
• URL: https://github.com/Automattic/republication-tracker-tool
• Owner: Automattic
• License: gpl-2.0
• Created: 2017-10-03T20:00:20.000Z (about 7 years ago)
• Default Branch: trunk
• Last Pushed: 2024-09-18T18:06:12.000Z (about 2 months ago)
• Last Synced: 2024-10-08T11:16:37.876Z (about 1 month ago)
• Topics: wordpress-plugin
• Language: PHP
• Homepage: https://wordpress.org/plugins/republication-tracker-tool/
• Size: 8.76 MB
• Stars: 8
• Watchers: 8
• Forks: 8
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Republication Tracker Tool #

**Contributors:** innlabs, Automattic

**Tags:** publishers, news

**Requires at least:** 4.4

**Requires PHP:** 5.3

**Tested up to:** 6.2

**Stable tag:** 1.0.2

**License:** GPLv2 or later

**License URI:** http://www.gnu.org/licenses/gpl-2.0.html

Adds a widget to allow readers to easily acquire Creative-Commons-licensed HTML of articles to facilitate embedding posts on external sites. Includes a tracking mechanism similar to ProPublica's PixelPing.

## Description ##

A plugin that allows users to add a widget to allow readers to easily acquire Creative-Commons-licensed HTML of articles to facilitate embedding posts on external sites. Includes a tracking mechanism similar to ProPublica's PixelPing. Built by [INN Labs](https://labs.inn.org/), now maintained by [Newspack](https://newspack.com/) and [Automattic](https://automattic.com/).

## Installation ##

1. Activate the plugin through the 'Plugins' menu in WordPress.

2. Configure plugin settings in the 'Settings' > 'Reading' menu.

3. Add the widget to your per-post sidebars. It doesn't work outside of single post pages.

## Frequently Asked Questions ##

### How does the tracking mechanism work? ###

The tracking mechanism is similiar to ProPublica's [PixelPing](https://www.propublica.org/pixelping) tracking technology.

In this plugin, the tracking is achieved through an image element included inside of the republishable content that collects data from the republishing site and sends that data to Google Analytics. Shared content views are tracked as pageview events in Google Analytics, with the shared URL listed as referrer. Supports both Universal Analytics and Google Analytics 4 protocols.