Contributor: Mathieu d'Aquin (@mdaquin) DEPRECATED: This project is superseded by the browsing-history-webext, which extends this project to also support Firefox and Opera.
The AFEL Chrome Browsing History Extension is one of the Browsing History Extractors developped in the AFEL Project. It is a chrome browser extension running in the background while you use the Chrome browser in the Web, and send information about your browsing to the AFEL Data Platform. It will require login onto the AFEL Data Platform, either with an existing account or through registration.
- Download or git clone into a local directory.
- In Chrome, go to settings, and choose extensions on the right hand menu
- At the top of the page, click on "Developper mode" if not already enabled.
- Use "Load unpacked extension" to select the directory where the extension has been downloaded.
Please make sure to read and accept the Terms and Conditions before downloading and activating this browser extension.
As soon as the extension is enabled, a new tab should appear in Chrome showing a login page to the AFEL data platform. Please (register)[http://data.afel-project.eu/catalogue/wp-login.php?action=register] if you don't already have an account. Once logged in, the extension will have obtained all the details needed to updload data about browsing activity on the AFEL Data Platform. A small icon will have also appeared on the right hand side of the browser's address bar, showing that the extension is active. Clicking on this icon will give you a link to the AFEL User Dashboard where you can monitor your own activity from this and other AFEL extractors.
This chrome extension represents a typical form of user-centric data extractor for the AFEL Data Platform. As such, it is worth detailing the workflow through which this interaction happens. This workflow is described in the diagram below.
where the Extractor application here is the Chorme extension and the login page is achieved through a local tab.
The API to provide dataset ID and user key in the platform is part of the Data Catalogue, through the Data Catalogue Process Plugin. The actual use data (in this case, browsing activity data), is transferred to the AFEL Data Platfrom through the Entity Centric API.
In addition to showing activity through the AFEL user dashboard, the AFEL Chrome Browsing History Extension will also update three API endpoints from which data can be obtained using the users unique API key. To use them, apply for example:
curl -u [your-api-key:] http://data.afel-platform.eu/api/entity/day/today
to get activities for the current day.
You can also use:
- http://data.afel-platform.eu/api/entity/day/25-08-206 (for example) for the a specific day
- http://data.afel-platform.eu/api/entity/month/current for the current month
- http://data.afel-platform.eu/api/entity/month/08-2016 (for example) for a specific month
- http://data.afel-platform.eu/api/entity/year/current for the current year
- http://data.afel-platform.eu/api/entity/year/2016 (for example) for a specific year
Note that these endpoints might also include data obtained from other extractors.
The AFEL Chrome Browsing History Extension us distributed under the Apache Licence V2. Please attribute Mathieu d'Aquin from The Open University through the AFEL Project when reusing and redistributing this code.