Getting Started
Â
- 1 Set up your local environment (with docker)
- 1.1.1 Prerequisites
- 1.2 Docker environment
- 1.2.1.1 Clone project
- 1.2.2 Init a project environment
- 1.2.3 Start a project environment
- 1.3 Init security settings
- 1.4 Initializing the portal application
- 2 Cloud environments
- 3 Configure your DAM
- 3.1 Quickly configure a DAM
- 3.1.1 1. Asset Metadata : Adapt the starter kit data model
- 3.1.2 2. UI Design : configure colors, logos, notification emails…
- 3.1.3 3. Home Page : configure images slider, widgets, and footer
- 3.1.4 4. TOS acceptation
- 3.1.5 5. General Menu : configure footer links
- 3.1.6 6. Universes Menu and filters : configure the universes menu, its filters, and the metadata displayed on block display mode
- 3.1.7 7. Roles
- 3.1.8 8. Creative workflow
- 3.2 DAM Configuration : go further
- 3.3 Feedbacks
- 3.1 Quickly configure a DAM
Set up your local environment (with docker)
Prerequisites
The following procedure assumes you have docker installed on your machine
Docker environment
Clone project https://bitbucket.org/wediaproduct/docker-compose-template-gul/src/master/
This repository contains a docker compose template for running the whole WEDIA application.
Make sure to read the README.md.
It is recommended to use this repository as a template that you can easily update (git pull).
→ Do not run your project from this cloned repository.
Init a project environment
Follow these steps every time you need to setup a new environment:
Copy the docker-compose-template folder to your own projects folder:
Assuming you cloned the repository in~/git-repositories/wedia-docker-template
and you store your projects in~/projects
, and you want to start projectprojectWedia
cd ~ cp -R ./git-repositories/wedia-docker-template ./my-projects/projectWedia
Delete content of folders
san
,db
andadmin
:cd ~/my-projects/projectWedia rm -rf ./san/* rm -rf ./admin/* rm -rf ./db/*
Start the whole docker environment (assuming ports 8080, 8000, 8888, are not used)
docker compose up
At this point, your server is started, you can start configuring it manually.
Init environment using predefined script
In order to ease the basic configuration of the platform, we provide a JS project: https://bitbucket.org/wediaproduct/wedia_auto_installer/src/master/. Clone this repository, then:
First time, init the projectThen you can finalize an environment configuration by running:
Start a project environment
Follow these steps every time you need to switch from one environment to another:
stop all your containers
move to environment folder
start environment
Init security settings
Security settings are initialized from the PACKAGED_Security plugin:
From <your wedia server>/admin/plugin/view?action=edit&name=PACKAGED_Security
Browse to Business Services tab
Open the swagger doc for
com.wedia.packaged.security.extensions.PackagedSecurityAdminApi
Open
/api/packaged/admin/security/update
Click Try it out
Click Execute
Initializing the portal application
To prepare the portal application, you need to clone the wediaproduct / portal repository
Once done, you will need to setup some basic information.
Make sure you are running on the appropriate node version (16)
run the following command
This will create a .wediaportalrc
file at the root of your project.
You will need to adapt generated content for your project.
The .wediaportalrc
file replaces .env
files that were used before.
If you are migrating from a previous version of the portal without a .wediaportalrc
file, you can automatically generate the .wediaportalrc
file based on your .env
files
npm run wediaportal -- restore
Cloud environments
MediaCloud setup
Do not forget to ask for a MediaCloud Wedia ID to ESAAS team. This is a requirements for:
Artificial intelligence features
Players
Video transcriptions
Documents transcriptions
Email server setup
Do not forget to ask ESAAS team to configure the smtp server, and to make sure the cloud environment is allowed to connect this server.
Â
Configure your DAM
Quickly configure a DAM
Starter kit comes with a workflow, and rights and roles, ready to use.
Once your starter kit is set up on a server : focus your efforts on the following points to set up your new DAM quickly.
1. Asset Metadata : Adapt the starter kit data model
Related documentation :
Manage Data Model and Configure metadata displayed on asset details : https://crossmedia.atlassian.net/wiki/spaces/WD/pages/2601713665
Starter kit data model : https://docs.google.com/spreadsheets/d/1Z4c4vn_YdQ59b83sRV5c19GPci9BJkrW/edit#gid=2086436237
2. UI Design : configure colors, logos, notification emails…
Related documentation :
Manage colors and logos : Manage logos and colors
3. Home Page : configure images slider, widgets, and footer
Related documentation :
Manage Images slider : Homepage | background sliding images as a dedicated contribution
Manage Widgets : https://crossmedia.atlassian.net/wiki/spaces/WD/pages/2098430016/Homepage#Widgets-area
Manage Footer links : Manage links in the menu and the footer
4. TOS acceptation
Related documentation :
5. General Menu : configure footer links
Related documentation :
Manage Menu links : Manage links in the menu and the footer
6. Universes Menu and filters : configure the universes menu, its filters, and the metadata displayed on block display mode
Related documentation :
Manage universes : Manage Search Filters and Universes
Manage search filters (top filters & advanced filters) : Manage Search Filters and Universes
Manage metadata displayed on the block display mode : Manage Search Filters and Universes
7. Roles
Related documentation :
Make sure you have a correct understanding of Starter kit role types and role management interface by reading the associated documentation : Role management interface
8. Creative workflow
Related documentation :
Make sure you have a correct understanding of Creative workflow by reading the associated documentation : Creative workflow
DAM Configuration : go further
The product documentation gives information for each DAM pages about :
How it works
Available configuration options and technical steps for the implementation
All the documentation available is under https://crossmedia.atlassian.net/wiki/spaces/WD/pages/2116255749
Feedbacks
You cannot find what you are looking for ?
Please leave us a comment so that we can improve the documentation !
You liked the documentation ?
Please give a like !