Tags are great, they are literally the best way we have of indicating what a piece of content is, what it’s about and where it came from. We use tags to generate navigation on theguardian.com and provide pages and pages of links to interesting content. Tags can be mapped which allows them to magically show rich contextual information from external systems on relevant pages. Everyone loves tags.
The tag manager allows the tags to be ... er ... managed
Before you run for the first time you will need to run ./scripts/setup.sh this will install and compile all the frontend
dependencies needed for the app (you may need to install npm before you can run this successfully). If any frontend
dependencies are changed you should re run the setup script.
N.B. If you encounter errors during setup when installing npm packages, use nvm or another node version manager to install and use the expected version of nodejs.
The Nginx setup uses the dev-nginx tool. After running this the tag manager will be available on https://tagmanager.local.dev-gutools.co.uk
To read the database and interact with the AWS infrastructure you will need AWS credentials that allow you access to the Composer account available to the default credentials provider chain. The easiest way to configure this is to obtain the credentials via janus and export the credentials to your shell using the handy script provided by janus.
Tag Manager also makes requests to CAPI preview. This means you will also need CAPI credentials from janus (with 'API Gateway invocation' permission).
If you are working on the commercial tag functionality and need to be able to upload logos you will also need AWS credentials for the frontend aws account available as an AWS profile named "frontend". This can also be obtained via janus.
If you want to integrate with Path Manager, e.g. to create tags, you'll need to create a tunnel from your local server (localhost 6000) to the Path Manager load balancer. This can be done using this command:
ssm ssh -x -t tag-manager,CODE -p composer --tunnel 6000:<internal-path-manager-url>:80
The internal path manager DNS name can be found in EC2 load balancers in AWS.
Run ./scripts/start.sh to start the full app.
We use webpack to compile the assets for this project. You have the option to run ./scripts/setup.sh after each change, or alternatively you can choose to use one of the alternative startup scripts provided
./scripts/start.shThis starts a webpack watcher in addition to running the application - The watcher will compile unminified code when it detects a change to the javascript. Refresh the webpage to see the new code../scripts/client-dev.shThis scripts starts a webpack-dev-server alongside the application which provides Hot Reloading. Changes you make to code should be immediately visible in the browser
The backend code used the standard scala play layout.
The frontend components live in the public directory in root. Css is compiled from sass file in the style directory.