digitalist-se / impono

Impono - Open source Tag Manager

Impono - Open Source Tag Manager

This project is based on SevenTag, when it was open source, from a backup done by tsteur.

Our goal is to make Impono Tag Manager the best open source tag manager available. Development is supported by Digitalist.

Impono uses Symfony, and a bunch of JavaScript frameworks and libraries - like Angular, Gulp, Bower etc.

Documentation on the UI

How to install Impono with Vagrant

vagrant up`
nvm use (local)
yarn install (local) [you need yarn installed for this - you could also use npm install]
gulp build (local)
composer install (inside box)
bin/console a:i (inside box)

In browser: http://impono.test/install.php and follow instructions.

How to install Impono with test user and data

Follow the inctructions to install with Vagrant, ssh into box, go to /var/www/impono then: bin/console doctrine:fixtures:load

Example user is [email protected] and password istesting

How to install in production.

We recomend that you use the offical docker image at Docker Hub.

Docker compose example:

Updating in production example:

docker-compose stop
docker-compose pull
docker volume prune -f
docker-compose up --force-recreate -d
docker exec -it application_app_1 composer bin/console a:i

docker cp copy/parameters.yml application_app_1:/var/www/app/config/parameters.yml
docker exec -it application_app_1 bin/console impono:republish -f
docker exec -it application_app_1 bin/console c:c
docker exec -it application_app_1 bin/console c:w
docker exec -it application_app_1 chmod 777 -R var

You could also use the code repo and add your settings to parameters.yml.

Impono follow the normal Symfony install procedure, see Symfony documentation.

Problem with install?

If having problem with phantomjs not in PATH, try this:

sudo wget  https://github.com/Medium/phantomjs/releases/download/v1.9.19/phantomjs-1.9.8-linux-x86_64.tar.bz2
sudo tar xvjf phantomjs-1.9.8-linux-x86_64.tar.bz2 -C /usr/local/share/
sudo ln -s /usr/local/share/phantomjs-1.9.8-linux-x86_64/bin/phantomjs /usr/local/bin/

Documentation

Documentation site is coming, for now see api.html in doc folder.

Technology stack

PHP 7.1 MariaDB Apache 2

License

• Free Software Foundation’s GNU AGPL, Version 3.

API examples

Example login

With an existing integration user

curl -X POST -d "client_id=12_5qpf73hq93swccow0844gko0g04g40s8soc0ssckoco4c0s0cc&client_secret=5rpg2t9bszs4g4o44gksgw8ggc8coo8408s080ko8kcgcwcggs&grant_type=client_credentials" http://impono.test/api/oauth/v2/token

or with JSON

curl -X POST -H "Content-Type: application/json" -d '{"client_id":"12_1n8epty5f9dwgo00048ggocksk0ogsogkw84w4c00w8w8080cs" , "client_secret":"4mko84fwz6gw8wc0sgc0sks8kksw480c4sw4g88wos4ggsksgw", "grant_type" : "client_credentials"}' http://impono.test/api/oauth/v2/token

Getting back:

{"access_token":"NTY5OWM2OTBjYzdmOWQwMTFjZTQwZmYwZWU1Y2U5NWI1ZTU3MDU3NDI5MmIzYzc0YzY1YTUzMGZiZDdiMTZhYw","expires_in":3600,"token_type":"bearer","scope":"user"}%   

With this my Authorization: Bearer is NTY5OWM2OTBjYzdmOWQwMTFjZTQwZmYwZWU1Y2U5NWI1ZTU3MDU3NDI5MmIzYzc0YzY1YTUzMGZiZDdiMTZhYw and I should use that to authorize requests.

Example call

curl --header "Authorization: Bearer NTY5OWM2OTBjYzdmOWQwMTFjZTQwZmYwZWU1Y2U5NWI1ZTU3MDU3NDI5MmIzYzc0YzY1YTUzMGZiZDdiMTZhYw" http://impono.test/api/containers

Getting back:

{"data":[{"id":11,"name":"Container name 10","description":"Container description 10","websites":[],"created_at":"2017-11-19T18:25:53+0000","updated_at":"2017-11-19T18:25:54+0000","has_unpublished_changes":true,"published_at":null,"permissions":["view","edit","publish","operator"]}],"total":1}%

So with this result - I can see that the user has access to one container, Container name 10

Getting a tag

curl -X "GET" --header "Authorization: Bearer NTY5OWM2OTBjYzdmOWQwMTFjZTQwZmYwZWU1Y2U5NWI1ZTU3MDU3NDI5MmIzYzc0YzY1YTUzMGZiZDdiMTZhYw" http://impono.test/api/tags/120

Deleting a tag

curl -X "DELETE" --header "Authorization: Bearer NTY5OWM2OTBjYzdmOWQwMTFjZTQwZmYwZWU1Y2U5NWI1ZTU3MDU3NDI5MmIzYzc0YzY1YTUzMGZiZDdiMTZhYw" http://impono.test/api/tags/120

Info about your user

curl -X "GET" --header "Authorization: Bearer NTY5OWM2OTBjYzdmOWQwMTFjZTQwZmYwZWU1Y2U5NWI1ZTU3MDU3NDI5MmIzYzc0YzY1YTUzMGZiZDdiMTZhYw" http://impono.test/api/users/me

Logout your user

curl -X "GET" --header "Authorization: Bearer NTY5OWM2OTBjYzdmOWQwMTFjZTQwZmYwZWU1Y2U5NWI1ZTU3MDU3NDI5MmIzYzc0YzY1YTUzMGZiZDdiMTZhYw" http://impono.test/api/users/me/logout

impono's Issues

Install broken because of node

Following the readme, now it is not possible to install the project on "fresh" computer:

gulp build

[11:03:27] Failed to load external module ts-node/register
[11:03:27] Failed to load external module typescript-node/register
[11:03:27] Failed to load external module typescript-register
[11:03:27] Failed to load external module typescript-require
/srv/www/impono/Gulpfile.ts:143
function fonts(sassSource: string, cssDest: string) {
                         ^
SyntaxError: Unexpected token :
    at Object.exports.runInThisContext (vm.js:53:16)
    at Module._compile (module.js:513:28)
    at Object.Module._extensions..js (module.js:550:10)
    at Module.load (module.js:458:32)
    at tryModuleLoad (module.js:417:12)
    at Function.Module._load (module.js:409:3)
    at Module.require (module.js:468:17)
    at require (internal/module.js:20:19)
    at Liftoff.handleArguments (/home/myuser/.nvm/versions/node/v6.2.2/lib/node_modules/gulp/bin/gulp.js:116:3)
    at Liftoff.<anonymous> (/home/myuser/.nvm/versions/node/v6.2.2/lib/node_modules/gulp/node_modules/liftoff/index.js:198:16)

Rebrand

Remove everything named 7tag, rename to impono

Upgrade to Symfony 3.3

Make install work

Now the install does not work

Triggers - Add a Javascript error tracking trigger

Adding a trigger and variables containing error info, that make it possible to trigger tags based on javascript error events in the browser.

Distibute impono with docker

This work is done in branch docker_image

Open Source Matomo Tag Manager

Hi there,

just fyi: As your tag manager is based on my backup I thought to let you know that we have just released the Free Open Source Matomo Tag Manager which is directly integrated into Matomo. Learn more about this powerful new Tag Manager here: https://matomo.org/blog/2018/06/free-open-source-matomo-tag-manager-now-available-as-a-beta/

And we would love if some developers are keen to contribute: https://matomo.org/blog/2018/06/developers-and-vendors-want-a-matomo-hoodie-add-a-tag-to-the-matomo-open-source-tag-manager-and-this-could-be-yours/

Cheers

Variables -- Add custom javascript variable

Add a variable that is based on Javascript or jQuery code

Trigger - Add scroll tracking triggers

Add triggers that make it possible to trigger tags based on scroll depth in the browser

Document API

Now the API is not documented, there could be a backup of the old 7tag documentation that is now not available online.

Variables - Make it possible to create variables from Piwik dimensions / data

It would be nice to be able to pick-up variables directly from Piwik, so that we for instance could trigger a tag if a certain set of variables match.

Create "easy" install package