add more tests (#268)

* add more tests as STUBS
2024-11-25 09:44:32 +01:00 · 2021-08-17 00:01:52 +03:00 · 2021-08-17 00:01:52 +03:00 · fb00f94bfa
commit fb00f94bfa
parent 755df50c41
29 changed files with 922 additions and 663 deletions
--- a/README.md
+++ b/README.md
@ -92,12 +92,12 @@ Visit [Releases Page](https://github.com/mediacms-io/mediacms/releases) for deta
 There are two ways to run MediaCMS, through Docker Compose and through installing it on a server via an automation script that installs and configures all needed services. Find the related pages:
-* [Single Server](docs/Single_Server.md) page
+* [Single Server](docs/admins_docs.md#2-server-installation) page
-* [Docker Compose](docs/Docker_Compose.md) page
+* [Docker Compose](docs/admins_docs.md#3-docker-installation) page
 ## Configuration
-Visit [Configuration](docs/Configuration.md) page.
+Visit [Configuration](docs/admins_docs.md#5-configuration) page.
 ## Documentation
--- a/Sidebar.md
+++ b/Sidebar.md
@ -1,133 +0,0 @@
 ## How To Add A Static Page To The Sidebar
 ### 1. Create your html page in templates/cms/ 
 e.g. duplicate and rename about.html
 ```
 sudo cp templates/cms/about.html templates/cms/volunteer.html
 ```
 ### 2. Create your css file in static/css/ 
 ```
 touch static/css/volunteer.css
 ```
 ### 3. In your html file, update block headermeta to reflect your new page
 ```
 {% block headermeta %}
 <meta property="og:title" content="Volunteer - {{PORTAL_NAME}}">
 <meta property="og:type" content="website">
 <meta property="og:description" content="">
 <meta name="twitter:card" content="summary">
 <script type="application/ld+json">
 {
 	"@context": "https://schema.org",
 	"@type": "BreadcrumbList",
 	"itemListElement": [{
 		"@type": "ListItem",
 		"position": 1,
        "name": "{{PORTAL_NAME}}",
        "item": {
 			"@type": "WebPage",
 	        "@id": "{{FRONTEND_HOST}}"
 	    }
    },
    {
 		"@type": "ListItem",
 		"position": 2,
        "name": "Volunteer",
        "item": {
 			"@type": "VolunteerPage",
 	        "@id": "{{FRONTEND_HOST}}/volunteer"
 	    }
    }]
 }
 </script>
 <link href="{% static "css/volunteer.css" %}" rel="stylesheet"/>
 {% endblock headermeta %}
 ```
 ### 4. In your html file, update block innercontent to reflect your actual content
 Write whatever you like.
 ### 5. In your css file, write matching styles for you html file.
 Write whatever you like.
 ### 6. Add your view to files/views.py
 ```
 def volunteer(request):
    """Volunteer view"""
    context = {}
    return render(request, "cms/volunteer.html", context)
 ```
 ### 7. Add your url pattern to files/urls.py
 ```
 urlpatterns = [
    url(r"^$", views.index),
    url(r"^about", views.about, name="about"),
    url(r"^volunteer", views.volunteer, name="volunteer"),
 ```
 ### 8. Add your page to the left sidebar
 To add a link to your page as a menu item in the left sidebar,
 add the following code after the last line in _commons.js   
 ```
 /* Checks that a given selector has loaded. */
 const checkElement = async selector => {
    while ( document.querySelector(selector) === null) {
      await new Promise( resolve =>  requestAnimationFrame(resolve) )
    }
    return document.querySelector(selector); 
  };
 /* Checks that sidebar nav menu has loaded, then adds menu item. */
 checkElement('.nav-menu')
 .then((element) => {
     (function(){    
        var a = document.createElement('a');        
        a.href = "/volunteer";
        a.title = "Volunteer";
        var s = document.createElement('span');
        s.className = "menu-item-icon";
        var icon = document.createElement('i');
        icon.className = "material-icons";
        icon.setAttribute("data-icon", "people");
        s.appendChild(icon);
        a.appendChild(s);
        var linkText = document.createTextNode("Volunteer");
        var t = document.createElement('span');
        t.appendChild(linkText);
        a.appendChild(t);
        var listItem = document.createElement('li');
        listItem.className = "link-item";
        listItem.appendChild(a);
        //if signed out use 3rd nav-menu
        var elem = document.querySelector(".nav-menu:nth-child(3) nav ul"); 
        var loc = elem.innerText;
        if (loc.includes("About")){
          elem.insertBefore(listItem, elem.children[2]);
        } else { //if signed in use 4th nav-menu
          elem = document.querySelector(".nav-menu:nth-child(4) nav ul");
          elem.insertBefore(listItem, elem.children[2]);
        }       
    })();
 });
 ```
 ### 9. Restart the mediacms web server
 On docker:
 ```
 sudo docker stop mediacms_web_1 && sudo docker start mediacms_web_1
 ```
 Otherwise
 ```
 sudo systemctl restart mediacms
 ```
--- a/docs/Configuration.md
+++ b/docs/Configuration.md
@ -1,270 +0,0 @@
 ## Configuration
 Several options are available on `cms/settings.py`, most of the things that are allowed or should be disallowed are described there.
 It is advisable to override any of them by adding it to `local_settings.py` . 
 In case of a the single server installation, add to `cms/local_settings.py` .
 In case of a docker compose installation, add to `deploy/docker/local_settings.py` . This will automatically overwrite `cms/local_settings.py` .
 Any change needs restart of MediaCMS in order to take effect. 
 Single server installation: edit `cms/local_settings.py`, make a change and restart MediaCMS 
 ```bash
 #systemctl restart mediacms
 ```
 Docker Compose installation: edit `deploy/docker/local_settings.py`, make a change and restart MediaCMS containers
 ```bash
 #docker-compose restart web celery_worker celery_beat
 ```
 ### change portal logo
 Set a new svg file for the white theme (`static/images/logo_dark.svg`) or the dark theme (`static/images/logo_light.svg`)
 ### set global portal title
 set `PORTAL_NAME`, eg
 ```
 PORTAL_NAME = 'my awesome portal'
 ```
 ### who can add media
 By default `CAN_ADD_MEDIA = "all"` means that all registered users can add media. Other valid options are:
 - **email_verified**, a user not only has to register an account but also verify the email (by clicking the link sent upon registration). Apparently email configuration need to work, otherise users won't receive emails. 
 - **advancedUser**, only users that are marked as advanced users can add media. Admins or MediaCMS managers can make users advanced users by editing their profile and selecting advancedUser.
 ### what is the portal workflow
 The `PORTAL_WORKFLOW` variable specifies what happens to newly uploaded media, whether they appear on listings (as the index page, or search)
 - **public** is the default option and means that a media can appear on listings. If media type is video, it will appear once at least a task that produces an encoded version of the file has finished succesfully. For other type of files, as image/audio they appear instantly
 - **private** means that newly uploaded content is private - only users can see it or MediaCMS editors, managers and admins. Those can also set the status to public or unlisted
 - **unlisted** means that items are unlisted. However if a user visits the url of an unlisted media, it will be shown (as opposed to private)
 ### show/hide the Sign in button
 to show button:
 ```
 LOGIN_ALLOWED = True
 ```
 to hide button:
 ```
 LOGIN_ALLOWED = False
 ```
 ### show/hide the Register button
 to show button:
 ```
 REGISTER_ALLOWED = True
 ```
 to hide button:
 ```
 REGISTER_ALLOWED = False
 ```
 ### show/hide the upload media button
 To show:
 ```
 UPLOAD_MEDIA_ALLOWED = True
 ```
 To hide:
 ```
 UPLOAD_MEDIA_ALLOWED = False
 ```
 ### show/hide the actions buttons (like/dislike/report)
 Make changes (True/False) to any of the following:
 ```
 - CAN_LIKE_MEDIA = True  # whether the like media appears
 - CAN_DISLIKE_MEDIA = True  # whether the dislike media appears
 - CAN_REPORT_MEDIA = True  # whether the report media appears
 - CAN_SHARE_MEDIA = True  # whether the share media appears
 ```
 ### show/hide the download option on a media
 Edit `templates/config/installation/features.html` and set 
 ```
 download: false
 ```
 ### automatically hide media upon being reported
 set a low number for variable `REPORTED_TIMES_THRESHOLD`
 eg 
 ```
 REPORTED_TIMES_THRESHOLD = 2
 ```
 once the limit is reached, media goes to private state and an email is sent to admins
 ### set a custom message on the media upload page
 this message will appear below the media drag and drop form
 ```
 PRE_UPLOAD_MEDIA_MESSAGE = 'custom message'
 ```
 ### set email settings
 Set correct settings per provider
 ```
 DEFAULT_FROM_EMAIL = 'info@mediacms.io'
 EMAIL_HOST_PASSWORD = 'xyz'
 EMAIL_HOST_USER = 'info@mediacms.io'
 EMAIL_USE_TLS = True
 SERVER_EMAIL = DEFAULT_FROM_EMAIL
 EMAIL_HOST = 'mediacms.io'
 EMAIL_PORT = 587
 ADMIN_EMAIL_LIST = ['info@mediacms.io']
 ```
 ### disallow user registrations from specific domains
 set domains that are not valid for registration via this variable:
 ```
 RESTRICTED_DOMAINS_FOR_USER_REGISTRATION = [
    'xxx.com', 'emaildomainwhatever.com']
 ```
 ### require a review by MediaCMS editors/managers/admins
 set value
 ```
 MEDIA_IS_REVIEWED = False
 ```
 any uploaded media now needs to be reviewed before it can appear to the listings. 
 MediaCMS editors/managers/admins can visit the media page and edit it, where they can see the option to mark media as reviewed. By default this is set to True, so all media don't require to be reviewed
 ### specify maximum number of media for a playlist
 set a different threshold on variable `MAX_MEDIA_PER_PLAYLIST`
 eg
 ```
 MAX_MEDIA_PER_PLAYLIST = 14
 ```
 ### specify maximum size of a media that can be uploaded
 change `UPLOAD_MAX_SIZE`. 
 default is 4GB
 ```
 UPLOAD_MAX_SIZE = 800 * 1024 * 1000 * 5
 ```
 ### specify maximum size of comments
 change `MAX_CHARS_FOR_COMMENT`
 default:
 ```
 MAX_CHARS_FOR_COMMENT = 10000
 ```
 ### how many files to upload in parallel
 set a different threshold for `UPLOAD_MAX_FILES_NUMBER`
 default:
 ```
 UPLOAD_MAX_FILES_NUMBER = 100
 ```
 ### force users confirm their email upon registrations
 default option for email confirmation is optional. Set this to mandatory in order to force users confirm their email before they can login
 ```
 ACCOUNT_EMAIL_VERIFICATION = 'optional'
 ```
 ### rate limit account login attempts
 after this number is reached
 ```
 ACCOUNT_LOGIN_ATTEMPTS_LIMIT = 20
 ```
 sets a timeout (in seconds)
 ```
 ACCOUNT_LOGIN_ATTEMPTS_TIMEOUT = 5
 ```
 ### disallow user registration
 set the following variable to False
 ```
 USERS_CAN_SELF_REGISTER = True
 ```
 ### configure notifications
 Global notifications that are implemented are controlled by the following options:
 ```
 USERS_NOTIFICATIONS = {
    'MEDIA_ADDED': True,    
 }
 ```
 If you want to disable notification for new media, set to False
 Admins also receive notifications on different events, set any of the following to False to disable
 ```
 ADMINS_NOTIFICATIONS = {
    'NEW_USER': True,
    'MEDIA_ADDED': True,
    'MEDIA_REPORTED': True,
 }
 ```
 - NEW_USER: a new user is added
 - MEDIA_ADDED: a media is added
 - MEDIA_REPORTED: the report for a media was hit
 ### Google Analytics
 Checkout the instructions by alberto98fx on [Google Analytics](/docs/robots_and_analytics.md) page.
--- a/docs/Docker_Compose.md
+++ b/docs/Docker_Compose.md
@ -1,59 +0,0 @@
 # Docker Compose
 ## Installation
 Install a recent version of [Docker](https://docs.docker.com/get-docker/), and [Docker Compose](https://docs.docker.com/compose/install/).
 For Ubuntu 18/20 systems this is:
 ```bash
 curl -fsSL https://get.docker.com -o get-docker.sh
 sudo sh get-docker.sh
 sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
 sudo chmod +x /usr/local/bin/docker-compose
 ```
 Then run as root
 ```bash
 git clone https://github.com/mediacms-io/mediacms
 cd mediacms
 ```
 The default option is to serve MediaCMS on all ips available of the server (including localhost).
 If you want to explore more options (including setup of https with letsencrypt certificate) checkout the docs on the [Docker deployment](/docs/Docker_deployment.md) page for different docker-compose setups to use.
 Run
 ```bash
 docker-compose up
 ```
 This will download all MediaCMS related Docker images and start all containers. Once it finishes, MediaCMS will be installed and available on http://localhost or http://ip
 A user admin has been created with random password, you should be able to see it at the end of migrations container, eg
 ```
 migrations_1     | Created admin user with password: gwg1clfkwf
 ```
 or if you have set the ADMIN_PASSWORD variable on docker-compose file you have used (example `docker-compose.yaml`), that variable will be set as the admin user's password
 ## Update
 Get latest MediaCMS image and stop/start containers
 ```bash
 cd /path/to/mediacms/installation
 docker pull mediacms/mediacms
 docker-compose down
 docker-compose up
 ```
 ## Configuration
 Checkout the configuration docs on [Configuration](/docs/Configuration.md) page.
 ## Maintenance
 Database is stored on ../postgres_data/ and media_files on media_files/
--- a/docs/Docker_deployment.md
+++ b/docs/Docker_deployment.md
@ -1,53 +0,0 @@
 # MediaCMS on Docker
 The mediacms image is built to use supervisord as the main process, which manages one or more services required to run mediacms. We can toggle which services are run in a given container by setting the environment variables below to `yes` or `no`:
 * ENABLE_UWSGI
 * ENABLE_NGINX
 * ENABLE_CELERY_BEAT
 * ENABLE_CELERY_SHORT
 * ENABLE_CELERY_LONG
 * ENABLE_MIGRATIONS
 By default, all these services are enabled, but in order to create a scaleable deployment, some of them can be disabled, splitting the service up into smaller services.
 Also see the `Dockerfile` for other environment variables which you may wish to override. Application settings, eg. `FRONTEND_HOST` can also be overridden by updating the `deploy/docker/local_settings.py` file.
 See example deployments in the sections below. These example deployments have been tested on `docker-compose version 1.27.4` running on `Docker version 19.03.13`
 To run, update the configs above if necessary, build the image by running `docker-compose build`, then run `docker-compose run`
 # Simple Deployment, accessed as http://localhost
 The main container runs migrations, mediacms_web, celery_beat, celery_workers (celery_short and celery_long services), exposed on port 80 supported by redis and postgres database.
 The FRONTEND_HOST in `deploy/docker/local_settings.py` is configured as http://localhost, on the docker host machine.
 # Server with ssl certificate through letsencrypt service, accessed as https://my_domain.com
 Before trying this out make sure the ip points to my_domain.com. 
 With this method [this deployment](../docker-compose-letsencrypt.yaml) is used. 
 Edit this file and set `VIRTUAL_HOST` as my_domain.com, `LETSENCRYPT_HOST` as my_domain.com, and your email on `LETSENCRYPT_EMAIL`
 Edit `deploy/docker/local_settings.py` and set https://my_domain.com as `FRONTEND_HOST`
 Now run docker-compose -f docker-compose-letsencrypt.yaml up, when installation finishes you will be able to access https://my_domain.com using a valid Letsencrypt certificate!
 # Advanced Deployment, accessed as http://localhost:8000
 Here we can run 1 mediacms_web instance, with the FRONTEND_HOST in `deploy/docker/local_settings.py` configured as http://localhost:8000. This is bootstrapped by a single migrations instance and supported by a single celery_beat instance and 1 or more celery_worker instances. Redis and postgres containers are also used for persistence. Clients can access the service on http://localhost:8000, on the docker host machine. This is similar to [this deployment](../docker-compose.yaml), with a `port` defined in FRONTEND_HOST.
 # Advanced Deployment, with reverse proxy, accessed as http://mediacms.io
 Here we can use `jwilder/nginx-proxy` to reverse proxy to 1 or more instances of mediacms_web supported by other services as mentioned in the previous deployment. The FRONTEND_HOST in `deploy/docker/local_settings.py` is configured as http://mediacms.io, nginx-proxy has port 80 exposed. Clients can access the service on http://mediacms.io (Assuming DNS or the hosts file is setup correctly to point to the IP of the nginx-proxy instance). This is similar to [this deployment](../docker-compose-http-proxy.yaml).
 # Advanced Deployment, with reverse proxy, accessed as https://localhost
 The reverse proxy (`jwilder/nginx-proxy`) can be configured to provide SSL termination using self-signed certificates, letsencrypt or CA signed certificates (see: https://hub.docker.com/r/jwilder/nginx-proxy or [LetsEncrypt Example](https://www.singularaspect.com/use-nginx-proxy-and-letsencrypt-companion-to-host-multiple-websites/) ). In this case the FRONTEND_HOST should be set to https://mediacms.io. This is similar to [this deployment](../docker-compose-http-proxy.yaml).
 # A Scaleable Deployment Architecture (Docker, Swarm, Kubernetes)
 The architecture below generalises all the deployment scenarios above, and provides a conceptual design for other deployments based on kubernetes and docker swarm. It allows for horizontal scaleability through the use of multiple mediacms_web instances and celery_workers. For large deployments, managed postgres, redis and storage may be adopted.
 ![MediaCMS](images/architecture.png)
--- a/docs/Single_Server.md
+++ b/docs/Single_Server.md
@ -1,38 +0,0 @@
 # Single Server
 ## Installation
 The core dependencies are Python3, Django3, Celery, PostgreSQL, Redis, ffmpeg. Any system that can have these dependencies installed, can run MediaCMS. But we strongly suggest installing on Linux Ubuntu 18 or 20 versions.
 Installation on a Ubuntu 18 or 20 system with git utility installed should be completed in a few minutes with the following steps.
 Make sure you run it as user root, on a clear system, since the automatic script will install and configure the following services: Celery/PostgreSQL/Redis/Nginx and will override any existing settings. 
 Automated script - tested on Ubuntu 18, Ubuntu 20, and Debian Buster
 ```bash
 mkdir /home/mediacms.io && cd /home/mediacms.io/
 git clone https://github.com/mediacms-io/mediacms
 cd /home/mediacms.io/mediacms/ && bash ./install.sh
 ```
 The script will ask if you have a URL where you want to deploy MediaCMS, otherwise it will use localhost. If you provide a URL, it will use Let's Encrypt service to install a valid ssl certificate. 
 ## Update
 If you've used the above way to install MediaCMS, update with the following:
 ```bash
 cd /home/mediacms.io/mediacms # enter mediacms directory
 source  /home/mediacms.io/bin/activate # use virtualenv
 git pull # update code
 python manage.py migrate # run Django migrations
 sudo systemctl restart mediacms celery_long celery_short # restart services
 ```
 ## Configuration
 Checkout the configuration docs on [Configuration](/docs/Configuration.md) page.
 ## Maintenance
 Database can be backed up with pg_dump and media_files on /home/mediacms.io/mediacms/media_files include original files and encoded/transcoded versions
--- a/docs/User_Scenarios.md
+++ b/docs/User_Scenarios.md
@ -1,20 +0,0 @@
 ## User scenarios to test
 ## test video media + image
    try uploading a video + image, make sure they get encoded well and check they appear on index/search/category/author page
    try editing/setting metadata, confirm action is performed, also that are searchable
    try adding custom poster, confirm it loads well on video page/listings
    try specifying different thumbnail time, confirm an automatic screenshot is taken
 ## portal workflow
    change workflow to unlisted, check they don't appear on index/search/category/author page
 ## users management
   create an admin, a MediaCMS editor and MediaCMS manager. All should see edit/delete on a media and also comments, and action should work.
   For users edit and delete, only MediaCMS manager and admin should see edit/delete and these actions should work.
 ## test subtitle
    add language and test subtitling
--- a/docs/admins_docs.md
+++ b/docs/admins_docs.md
@ -1,29 +1,650 @@
 # Administrators documentation
 ## Table of contents
- [Manage pages](#manage-pages)
+- [1. Welcome](#1-welcome)
- [Django admin dashboard](#django-admin-dashboard)
+- [2. Server Installaton](#2-server-installation)
- [On portal workflow](#on-portal-workflow)
+- [3. Docker Installation](#3-docker-installation)
- [On user roles](#on-user-roles)
+- [4. Docker Deployement options](#4-docker-deployment-options)
- [Adding languages for Captions and subtitles](#adding-languages-for-captions-and-subtitles)
+- [5. Configuration](#5-configuration)
- [Add/delete categories and tags](#adddelete-categories-and-tags)
+- [6. Manage pages](#6-manage-pages)
- [Video transcoding](#video-transcoding)
+- [7. Django admin dashboard](#7-django-admin-dashboard)
 - [8. On portal workflow](#8-on-portal-workflow)
 - [9. On user roles](#9-on-user-roles)
 - [10. Adding languages for Captions and subtitles](#10-adding-languages-for-captions-and-subtitles)
 - [11. Add/delete categories and tags](#11-adddelete-categories-and-tags)
 - [12. Video transcoding](#12-video-transcoding)
 - [13. How To Add A Static Page To The Sidebar](#13-how-to-add-a-static-page-to-the-sidebar)
 - [14. Add Google Analytics](#14-add-google-analytics)
-## Manage pages
+## 1. Welcome
 This page is created for MediaCMS administrators that are responsible for setting up the software, maintaining it and making modifications. 
-## Django admin dashboard
+## 2. Server Installation
-## On portal workflow
+The core dependencies are Python3, Django3, Celery, PostgreSQL, Redis, ffmpeg. Any system that can have these dependencies installed, can run MediaCMS. But we strongly suggest installing on Linux Ubuntu 18 or 20 versions.
 Installation on a Ubuntu 18 or 20 system with git utility installed should be completed in a few minutes with the following steps.
 Make sure you run it as user root, on a clear system, since the automatic script will install and configure the following services: Celery/PostgreSQL/Redis/Nginx and will override any existing settings. 
 Automated script - tested on Ubuntu 18, Ubuntu 20, and Debian Buster
 ```bash
 mkdir /home/mediacms.io && cd /home/mediacms.io/
 git clone https://github.com/mediacms-io/mediacms
 cd /home/mediacms.io/mediacms/ && bash ./install.sh
 ```
 The script will ask if you have a URL where you want to deploy MediaCMS, otherwise it will use localhost. If you provide a URL, it will use Let's Encrypt service to install a valid ssl certificate. 
 ### Update
 If you've used the above way to install MediaCMS, update with the following:
 ```bash
 cd /home/mediacms.io/mediacms # enter mediacms directory
 source  /home/mediacms.io/bin/activate # use virtualenv
 git pull # update code
 python manage.py migrate # run Django migrations
 sudo systemctl restart mediacms celery_long celery_short # restart services
 ```
 ### Configuration
 Checkout the configuration section here.
 ### Maintenance
 Database can be backed up with pg_dump and media_files on /home/mediacms.io/mediacms/media_files include original files and encoded/transcoded versions
 ## 3. Docker Installation
 ## Installation
 Install a recent version of [Docker](https://docs.docker.com/get-docker/), and [Docker Compose](https://docs.docker.com/compose/install/).
 For Ubuntu 18/20 systems this is:
 ```bash
 curl -fsSL https://get.docker.com -o get-docker.sh
 sudo sh get-docker.sh
 sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
 sudo chmod +x /usr/local/bin/docker-compose
 ```
 Then run as root
 ```bash
 git clone https://github.com/mediacms-io/mediacms
 cd mediacms
 ```
 The default option is to serve MediaCMS on all ips available of the server (including localhost).
 If you want to explore more options (including setup of https with letsencrypt certificate) checkout [Docker deployment](/docs/admins_docs.md#4-docker-deployment-options) section for different docker-compose setups to use.
 Run
 ```bash
 docker-compose up
 ```
 This will download all MediaCMS related Docker images and start all containers. Once it finishes, MediaCMS will be installed and available on http://localhost or http://ip
 A user admin has been created with random password, you should be able to see it at the end of migrations container, eg
 ```
 migrations_1     | Created admin user with password: gwg1clfkwf
 ```
 or if you have set the ADMIN_PASSWORD variable on docker-compose file you have used (example `docker-compose.yaml`), that variable will be set as the admin user's password
 ### Update
 Get latest MediaCMS image and stop/start containers
 ```bash
 cd /path/to/mediacms/installation
 docker pull mediacms/mediacms
 docker-compose down
 docker-compose up
 ```
 ## Configuration
 Checkout the configuration docs here.
 ### Maintenance
 Database is stored on ../postgres_data/ and media_files on media_files/
 ## 4. Docker Deployment options
 The mediacms image is built to use supervisord as the main process, which manages one or more services required to run mediacms. We can toggle which services are run in a given container by setting the environment variables below to `yes` or `no`:
 * ENABLE_UWSGI
 * ENABLE_NGINX
 * ENABLE_CELERY_BEAT
 * ENABLE_CELERY_SHORT
 * ENABLE_CELERY_LONG
 * ENABLE_MIGRATIONS
 By default, all these services are enabled, but in order to create a scaleable deployment, some of them can be disabled, splitting the service up into smaller services.
 Also see the `Dockerfile` for other environment variables which you may wish to override. Application settings, eg. `FRONTEND_HOST` can also be overridden by updating the `deploy/docker/local_settings.py` file.
 See example deployments in the sections below. These example deployments have been tested on `docker-compose version 1.27.4` running on `Docker version 19.03.13`
 To run, update the configs above if necessary, build the image by running `docker-compose build`, then run `docker-compose run`
 ### Simple Deployment, accessed as http://localhost
 The main container runs migrations, mediacms_web, celery_beat, celery_workers (celery_short and celery_long services), exposed on port 80 supported by redis and postgres database.
 The FRONTEND_HOST in `deploy/docker/local_settings.py` is configured as http://localhost, on the docker host machine.
 ### Server with ssl certificate through letsencrypt service, accessed as https://my_domain.com
 Before trying this out make sure the ip points to my_domain.com. 
 With this method [this deployment](../docker-compose-letsencrypt.yaml) is used. 
 Edit this file and set `VIRTUAL_HOST` as my_domain.com, `LETSENCRYPT_HOST` as my_domain.com, and your email on `LETSENCRYPT_EMAIL`
 Edit `deploy/docker/local_settings.py` and set https://my_domain.com as `FRONTEND_HOST`
 Now run docker-compose -f docker-compose-letsencrypt.yaml up, when installation finishes you will be able to access https://my_domain.com using a valid Letsencrypt certificate!
 ### Advanced Deployment, accessed as http://localhost:8000
 Here we can run 1 mediacms_web instance, with the FRONTEND_HOST in `deploy/docker/local_settings.py` configured as http://localhost:8000. This is bootstrapped by a single migrations instance and supported by a single celery_beat instance and 1 or more celery_worker instances. Redis and postgres containers are also used for persistence. Clients can access the service on http://localhost:8000, on the docker host machine. This is similar to [this deployment](../docker-compose.yaml), with a `port` defined in FRONTEND_HOST.
 ### Advanced Deployment, with reverse proxy, accessed as http://mediacms.io
 Here we can use `jwilder/nginx-proxy` to reverse proxy to 1 or more instances of mediacms_web supported by other services as mentioned in the previous deployment. The FRONTEND_HOST in `deploy/docker/local_settings.py` is configured as http://mediacms.io, nginx-proxy has port 80 exposed. Clients can access the service on http://mediacms.io (Assuming DNS or the hosts file is setup correctly to point to the IP of the nginx-proxy instance). This is similar to [this deployment](../docker-compose-http-proxy.yaml).
 ### Advanced Deployment, with reverse proxy, accessed as https://localhost
 The reverse proxy (`jwilder/nginx-proxy`) can be configured to provide SSL termination using self-signed certificates, letsencrypt or CA signed certificates (see: https://hub.docker.com/r/jwilder/nginx-proxy or [LetsEncrypt Example](https://www.singularaspect.com/use-nginx-proxy-and-letsencrypt-companion-to-host-multiple-websites/) ). In this case the FRONTEND_HOST should be set to https://mediacms.io. This is similar to [this deployment](../docker-compose-http-proxy.yaml).
 ### A Scaleable Deployment Architecture (Docker, Swarm, Kubernetes)
 The architecture below generalises all the deployment scenarios above, and provides a conceptual design for other deployments based on kubernetes and docker swarm. It allows for horizontal scaleability through the use of multiple mediacms_web instances and celery_workers. For large deployments, managed postgres, redis and storage may be adopted.
 ![MediaCMS](images/architecture.png)
 ## 5. Configuration
 Several options are available on `cms/settings.py`, most of the things that are allowed or should be disallowed are described there.
 It is advisable to override any of them by adding it to `local_settings.py` . 
 In case of a the single server installation, add to `cms/local_settings.py` .
 In case of a docker compose installation, add to `deploy/docker/local_settings.py` . This will automatically overwrite `cms/local_settings.py` .
 Any change needs restart of MediaCMS in order to take effect. 
 Single server installation: edit `cms/local_settings.py`, make a change and restart MediaCMS 
 ```bash
 #systemctl restart mediacms
 ```
 Docker Compose installation: edit `deploy/docker/local_settings.py`, make a change and restart MediaCMS containers
 ```bash
 #docker-compose restart web celery_worker celery_beat
 ```
 ### 5.1 Change portal logo
 Set a new svg file for the white theme (`static/images/logo_dark.svg`) or the dark theme (`static/images/logo_light.svg`)
 ### 5.2 Set global portal title
 set `PORTAL_NAME`, eg
 ```
 PORTAL_NAME = 'my awesome portal'
 ```
 ### 5.3 Control who can add media
 By default `CAN_ADD_MEDIA = "all"` means that all registered users can add media. Other valid options are:
 - **email_verified**, a user not only has to register an account but also verify the email (by clicking the link sent upon registration). Apparently email configuration need to work, otherise users won't receive emails. 
 - **advancedUser**, only users that are marked as advanced users can add media. Admins or MediaCMS managers can make users advanced users by editing their profile and selecting advancedUser.
 ### 5.4 What is the portal workflow
 The `PORTAL_WORKFLOW` variable specifies what happens to newly uploaded media, whether they appear on listings (as the index page, or search)
 - **public** is the default option and means that a media can appear on listings. If media type is video, it will appear once at least a task that produces an encoded version of the file has finished succesfully. For other type of files, as image/audio they appear instantly
 - **private** means that newly uploaded content is private - only users can see it or MediaCMS editors, managers and admins. Those can also set the status to public or unlisted
 - **unlisted** means that items are unlisted. However if a user visits the url of an unlisted media, it will be shown (as opposed to private)
 ### 5.5 Show or hide the Sign in button
 to show button:
 ```
 LOGIN_ALLOWED = True
 ```
 to hide button:
 ```
 LOGIN_ALLOWED = False
 ```
 ### 5.6 Show or hide the Register button
 to show button:
 ```
 REGISTER_ALLOWED = True
 ```
 to hide button:
 ```
 REGISTER_ALLOWED = False
 ```
 ### 5.7 Show or hide the upload media button
 To show:
 ```
 UPLOAD_MEDIA_ALLOWED = True
 ```
 To hide:
 ```
 UPLOAD_MEDIA_ALLOWED = False
 ```
 ### 5.8 Show or hide the actions buttons (like/dislike/report)
 Make changes (True/False) to any of the following:
 ```
 - CAN_LIKE_MEDIA = True  # whether the like media appears
 - CAN_DISLIKE_MEDIA = True  # whether the dislike media appears
 - CAN_REPORT_MEDIA = True  # whether the report media appears
 - CAN_SHARE_MEDIA = True  # whether the share media appears
 ```
 ### 5.9 Show or hide the download option on a media
 Edit `templates/config/installation/features.html` and set 
 ```
 download: false
 ```
 ### 5.10 Automatically hide media upon being reported
 set a low number for variable `REPORTED_TIMES_THRESHOLD`
 eg 
 ```
 REPORTED_TIMES_THRESHOLD = 2
 ```
 once the limit is reached, media goes to private state and an email is sent to admins
 ### 5.11 Set a custom message on the media upload page
 this message will appear below the media drag and drop form
 ```
 PRE_UPLOAD_MEDIA_MESSAGE = 'custom message'
 ```
 ### 5.12 Set email settings
 Set correct settings per provider
 ```
 DEFAULT_FROM_EMAIL = 'info@mediacms.io'
 EMAIL_HOST_PASSWORD = 'xyz'
 EMAIL_HOST_USER = 'info@mediacms.io'
 EMAIL_USE_TLS = True
 SERVER_EMAIL = DEFAULT_FROM_EMAIL
 EMAIL_HOST = 'mediacms.io'
 EMAIL_PORT = 587
 ADMIN_EMAIL_LIST = ['info@mediacms.io']
 ```
 ### 5.13 Disallow user registrations from specific domains
 set domains that are not valid for registration via this variable:
 ```
 RESTRICTED_DOMAINS_FOR_USER_REGISTRATION = [
    'xxx.com', 'emaildomainwhatever.com']
 ```
 ### 5.14 Require a review by MediaCMS editors/managers/admins
 set value
 ```
 MEDIA_IS_REVIEWED = False
 ```
 any uploaded media now needs to be reviewed before it can appear to the listings. 
 MediaCMS editors/managers/admins can visit the media page and edit it, where they can see the option to mark media as reviewed. By default this is set to True, so all media don't require to be reviewed
 ### 5.15 Specify maximum number of media for a playlist
 set a different threshold on variable `MAX_MEDIA_PER_PLAYLIST`
 eg
 ```
 MAX_MEDIA_PER_PLAYLIST = 14
 ```
 ### 5.16 Specify maximum size of a media that can be uploaded
 change `UPLOAD_MAX_SIZE`. 
 default is 4GB
 ```
 UPLOAD_MAX_SIZE = 800 * 1024 * 1000 * 5
 ```
 ### 5.17 Specify maximum size of comments
 change `MAX_CHARS_FOR_COMMENT`
 default:
 ```
 MAX_CHARS_FOR_COMMENT = 10000
 ```
 ### 5.18 How many files to upload in parallel
 set a different threshold for `UPLOAD_MAX_FILES_NUMBER`
 default:
 ```
 UPLOAD_MAX_FILES_NUMBER = 100
 ```
 ### 5.18 force users confirm their email upon registrations
 default option for email confirmation is optional. Set this to mandatory in order to force users confirm their email before they can login
 ```
 ACCOUNT_EMAIL_VERIFICATION = 'optional'
 ```
 ### 5.20 Rate limit account login attempts
 after this number is reached
 ```
 ACCOUNT_LOGIN_ATTEMPTS_LIMIT = 20
 ```
 sets a timeout (in seconds)
 ```
 ACCOUNT_LOGIN_ATTEMPTS_TIMEOUT = 5
 ```
 ### 5.21 Disallow user registration
 set the following variable to False
 ```
 USERS_CAN_SELF_REGISTER = True
 ```
 ### 5.22 Configure notifications
 Global notifications that are implemented are controlled by the following options:
 ```
 USERS_NOTIFICATIONS = {
    'MEDIA_ADDED': True,    
 }
 ```
 If you want to disable notification for new media, set to False
 Admins also receive notifications on different events, set any of the following to False to disable
 ```
 ADMINS_NOTIFICATIONS = {
    'NEW_USER': True,
    'MEDIA_ADDED': True,
    'MEDIA_REPORTED': True,
 }
 ```
 - NEW_USER: a new user is added
 - MEDIA_ADDED: a media is added
 - MEDIA_REPORTED: the report for a media was hit
 ## 6. Manage pages
 to be written
 ## 7. Django admin dashboard
 ## 8. On portal workflow
 Who can publish content, how content appears on public listings.Difference between statuses (private, unlisted, public)
-## On user roles
+## 9. On user roles
 Differences over MediaCMS manager, MediaCMS editor, logged in user
-## Adding languages for Captions and subtitles
+## 10. Adding languages for Captions and subtitles
 to be written
-## Add/delete categories and tags
+## 11. Add/delete categories and tags
 Through the admin section - http://your_installation/admin/
-## Video transcoding
+## 12. Video transcoding
 Add / remove resolutions and profiles through http://your_installation/admin/encodeprofile
 ## 13. How To Add A Static Page To The Sidebar
 ### 1. Create your html page in templates/cms/ 
 e.g. duplicate and rename about.html
 ```
 sudo cp templates/cms/about.html templates/cms/volunteer.html
 ```
 ### 2. Create your css file in static/css/ 
 ```
 touch static/css/volunteer.css
 ```
 ### 3. In your html file, update block headermeta to reflect your new page
 ```
 {% block headermeta %}
 <meta property="og:title" content="Volunteer - {{PORTAL_NAME}}">
 <meta property="og:type" content="website">
 <meta property="og:description" content="">
 <meta name="twitter:card" content="summary">
 <script type="application/ld+json">
 {
 	"@context": "https://schema.org",
 	"@type": "BreadcrumbList",
 	"itemListElement": [{
 		"@type": "ListItem",
 		"position": 1,
        "name": "{{PORTAL_NAME}}",
        "item": {
 			"@type": "WebPage",
 	        "@id": "{{FRONTEND_HOST}}"
 	    }
    },
    {
 		"@type": "ListItem",
 		"position": 2,
        "name": "Volunteer",
        "item": {
 			"@type": "VolunteerPage",
 	        "@id": "{{FRONTEND_HOST}}/volunteer"
 	    }
    }]
 }
 </script>
 <link href="{% static "css/volunteer.css" %}" rel="stylesheet"/>
 {% endblock headermeta %}
 ```
 ### 4. In your html file, update block innercontent to reflect your actual content
 Write whatever you like.
 ### 5. In your css file, write matching styles for you html file.
 Write whatever you like.
 ### 6. Add your view to files/views.py
 ```
 def volunteer(request):
    """Volunteer view"""
    context = {}
    return render(request, "cms/volunteer.html", context)
 ```
 ### 7. Add your url pattern to files/urls.py
 ```
 urlpatterns = [
    url(r"^$", views.index),
    url(r"^about", views.about, name="about"),
    url(r"^volunteer", views.volunteer, name="volunteer"),
 ```
 ### 8. Add your page to the left sidebar
 To add a link to your page as a menu item in the left sidebar,
 add the following code after the last line in _commons.js   
 ```
 /* Checks that a given selector has loaded. */
 const checkElement = async selector => {
    while ( document.querySelector(selector) === null) {
      await new Promise( resolve =>  requestAnimationFrame(resolve) )
    }
    return document.querySelector(selector); 
  };
 /* Checks that sidebar nav menu has loaded, then adds menu item. */
 checkElement('.nav-menu')
 .then((element) => {
     (function(){    
        var a = document.createElement('a');        
        a.href = "/volunteer";
        a.title = "Volunteer";
        var s = document.createElement('span');
        s.className = "menu-item-icon";
        var icon = document.createElement('i');
        icon.className = "material-icons";
        icon.setAttribute("data-icon", "people");
        s.appendChild(icon);
        a.appendChild(s);
        var linkText = document.createTextNode("Volunteer");
        var t = document.createElement('span');
        t.appendChild(linkText);
        a.appendChild(t);
        var listItem = document.createElement('li');
        listItem.className = "link-item";
        listItem.appendChild(a);
        //if signed out use 3rd nav-menu
        var elem = document.querySelector(".nav-menu:nth-child(3) nav ul"); 
        var loc = elem.innerText;
        if (loc.includes("About")){
          elem.insertBefore(listItem, elem.children[2]);
        } else { //if signed in use 4th nav-menu
          elem = document.querySelector(".nav-menu:nth-child(4) nav ul");
          elem.insertBefore(listItem, elem.children[2]);
        }       
    })();
 });
 ```
 ### 9. Restart the mediacms web server
 On docker:
 ```
 sudo docker stop mediacms_web_1 && sudo docker start mediacms_web_1
 ```
 Otherwise
 ```
 sudo systemctl restart mediacms
 ```
 ## 14. Add Google Analytics
 Instructions contributed by @alberto98fx
 1. Create a file:
 ``` touch $DIR/mediacms/templates/tracking.html ```
 2. Add the Gtag/Analytics script
 3. Inside ``` $DIR/mediacms/templates/root.html``` you'll see a file like this one: 
 ```
 <head>
    {% block head %}
        <title>{% block headtitle %}{{PORTAL_NAME}}{% endblock headtitle %}</title>
        {% include "common/head-meta.html" %}
        {% block headermeta %}
        <meta property="og:title" content="{{PORTAL_NAME}}">
        <meta property="og:type" content="website">
        {%endblock headermeta %}
        {% block externallinks %}{% endblock externallinks %}
        {% include "common/head-links.html" %}
        {% block topimports %}{%endblock topimports %}
        {% include "config/index.html" %}
    {% endblock head %}
 </head>
 ```
 4. Add  ``` {% include "tracking.html" %} ``` at the end inside the section ```<head>```
 5. If you are using Docker and didn't  mount the entire dir you need to bind a new volume: 
 ```
    web:
    image: mediacms/mediacms:latest
    restart: unless-stopped
    ports:
      - "80:80"
    deploy:
      replicas: 1
    volumes:
      - ./templates/root.html:/home/mediacms.io/mediacms/templates/root.html
      - ./templates/tracking.html://home/mediacms.io/mediacms/templates/tracking.html
 ```
--- a/docs/developers_docs.md
+++ b/docs/developers_docs.md
@ -1,26 +1,31 @@
 # Developers documentation
 ## Table of contents
- [System architecture](#system-architecture)
+- [1. Welcome](#1-welcome)
- [API documentation](#api-documentation)
+- [2. System architecture](#2-system-architecture)
- [How to contribute](#how-to-contribute)
+- [3. API documentation](#3-api-documentation)
- [Working with Docker tips](#working-with-docker-tips)
+- [4. How to contribute](#4-how-to-contribute)
- [How video is transcoded](#how-video-is-transcoded)
+- [5. Working with Docker tips](#5-working-with-docker-tips)
 - [6. Working with the automated tests](#6-working-with-the-automated-tests)
 - [7. How video is transcoded](#7-how-video-is-transcoded)
-## How to contribute
+## 1. Welcome
 This page is created for MediaCMS developers and contains related information.
 ## 2. System architecture
 to be written
 ## 3. API documentation
 API is documented using Swagger - checkout ot http://your_installation/swagger - example https://demo.mediacms.io/swagger/
 This page allows you to login to perform authenticated actions - it will also use your session if logged in. 
 ## 4. How to contribute
 Before you send a PR, make sure your code is properly formatted. For that, use `pre-commit install` to install a pre-commit hook and run `pre-commit run --all` and fix everything before you commit. This pre-commit will check for your code lint everytime you commit a code.
 Checkout the [Code of conduct page](../CODE_OF_CONDUCT.md) if you want to contribute to this repository
-## System architecture
+## 5. Working with Docker tips
 ## API documentation
 API is documented using Swagger - checkout ot http://your_installation/swagger - example https://demo.mediacms.io/swagger/
 This page allows you to login to perform authenticated actions - it will also use your session if logged in. 
 ## Working with Docker tips
 To perform the Docker installation, follow instructions to install Docker + Docker compose (docs/Docker_Compose.md) and then build/start docker-compose-dev.yaml . This will run the frontend application on port 8088 on top of all other containers (including the Django web application on port 80)
@ -33,7 +38,7 @@ docker-compose -f docker-compose-dev.yaml up
 Eg change `frontend/src/static/js/pages/HomePage.tsx` , dev application refreshes in a number of seconds (hot reloading) and I see the changes, once I'm happy I can run
 ```
-docker-compose -f docker-compose-dev.yaml -T frontend npm run dist
+docker-compose -f docker-compose-dev.yaml exec -T frontend npm run dist
 ```
 And then in order for the changes to be visible on the application while served through nginx, 
@ -50,7 +55,8 @@ Media page: need to upload content through the main application (nginx/port 80),
 There are some issues with CORS too to resolve, in order for some pages to function, eg the manage comments page
-```http://localhost:8088/manage-media.html px manage_media
+```
 http://localhost:8088/manage-media.html manage_media
 ```
 ### Backend application changes
@ -81,3 +87,42 @@ there is also an experimental small service (not commited to the repo currently)
 When the Encode object is marked as success and chunk=False, and thus is available for download/stream, there is a task that gets started and saves an HLS version of the file (1 mp4-->x number of small .ts chunks). This would be FILES_C
 This mechanism allows for workers that have access on the same filesystem (either localhost, or through a shared network filesystem, eg NFS/EFS) to work on the same time and produce results. 
 ## 6. Working with the automated tests
 This instructions assume that you're using the docker installation
 1. start docker-compose
 ```
 docker-compose up
 ```
 2. Install the requirements on `requirements-dev.txt ` on web container (we'll use the web container for this)
 ```
 docker-compose exec -T web pip install -r requirements-dev.txt 
 ```
 3. Now you can run the existing tests
 ```
 docker-compose exec --env TESTING=True -T web pytest
 ```
 The `TESTING=True` is passed for Django to be aware this is a testing environment (so that it runs Celery tasks as functions for example and not as background tasks, since Celery is not started in the case of pytest)
 4. You may try a single test, by specifying the path, for example
 ```
 docker-compose exec --env TESTING=True -T web pytest tests/test_fixtures.py
 ```
 5. You can also see the coverage
 ```
 docker-compose exec --env TESTING=True -T web pytest --cov=. --cov-report=html
 ```
 and of course...you are very welcome to help us increase it ;)
--- a/docs/robots_and_analytics.md
+++ b/docs/robots_and_analytics.md
@ -1,55 +0,0 @@
 # Google Analytics
 1. Create a file:
 ``` touch $DIR/mediacms/templates/tracking.html ```
 2. Add the Gtag/Analytics script
 3. Inside ``` $DIR/mediacms/templates/root.html``` you'll see a file like this one: 
 ```
 <head>
    {% block head %}
        <title>{% block headtitle %}{{PORTAL_NAME}}{% endblock headtitle %}</title>
        {% include "common/head-meta.html" %}
        {% block headermeta %}
        <meta property="og:title" content="{{PORTAL_NAME}}">
        <meta property="og:type" content="website">
        {%endblock headermeta %}
        {% block externallinks %}{% endblock externallinks %}
        {% include "common/head-links.html" %}
        {% block topimports %}{%endblock topimports %}
        {% include "config/index.html" %}
    {% endblock head %}
 </head>
 ```
 4. Add  ``` {% include "tracking.html" %} ``` at the end inside the section ```<head>```
 5. If you are using Docker and didn't  mount the entire dir you need to bind a new volume: 
 ```
    web:
    image: mediacms/mediacms:latest
    restart: unless-stopped
    ports:
      - "80:80"
    deploy:
      replicas: 1
    volumes:
      - ./templates/root.html:/home/mediacms.io/mediacms/templates/root.html
      - ./templates/tracking.html://home/mediacms.io/mediacms/templates/tracking.html
 ```
--- a/tests/api/test_manage_apis_TOWRITE.py
+++ b/tests/api/test_manage_apis_TOWRITE.py
@ -0,0 +1,10 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # check only managers/editors/admins have access here!!!
        pass
--- a/tests/api/test_media_listings_TOWRITE.py
+++ b/tests/api/test_media_listings_TOWRITE.py
@ -0,0 +1,10 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test a number of listings works (index, featured, user etc)
        pass
--- a/tests/api/test_new_file_TOWRITE.py
+++ b/tests/api/test_new_file_TOWRITE.py
@ -0,0 +1,9 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # add new file, check it is added and more (eg for videos it is transcoded etc)
        pass
--- a/tests/api/test_search_TOWRITE.py
+++ b/tests/api/test_search_TOWRITE.py
@ -0,0 +1,10 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # add a few files, check search different cases that work
        pass
--- a/tests/forms/test_contact_TOWRITE.py
+++ b/tests/forms/test_contact_TOWRITE.py
@ -0,0 +1,9 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test contact form, send a message and check on email box that it is received
        pass
--- a/tests/forms/test_edit_media_TOWRITE.py
+++ b/tests/forms/test_edit_media_TOWRITE.py
@ -0,0 +1,12 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test edit media that it works, by setting different values. then check on the API response
        # check that a user cannot set status upon different scenarios (eg on settings PORTAL_WORKFLOW)
        # check that changint thumbnail time produces a different thumbnail?
        # check adding custom poster, and that it appears instead of the autogenerated?
        pass
--- a/tests/forms/test_edit_profile_TOWRITE.py
+++ b/tests/forms/test_edit_profile_TOWRITE.py
@ -0,0 +1,9 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test edit profile page that it stores correctly the data
        pass
--- a/tests/forms/test_login_TOWRITE.py
+++ b/tests/forms/test_login_TOWRITE.py
@ -0,0 +1,12 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test login form that allows user to login
        # test login form that redirect has worked (if on a page that required redirect for login, eg edit profile?)
        # check upon setting change that it is not allowed
        pass
--- a/tests/forms/test_media_upload_TOWRITE.py
+++ b/tests/forms/test_media_upload_TOWRITE.py
@ -0,0 +1,13 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test media upload, using the form.
        # 1. upload a file and then check that it appears on the listing
        # 2. check that the page has been created
        # 3. check that encodings are ok for videos
        # 4. check other things (eg pdf/audio/image)
        pass
--- a/tests/forms/test_register_TOWRITE.py
+++ b/tests/forms/test_register_TOWRITE.py
@ -0,0 +1,10 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test register form that stores user data correctly
        # check upon setting change that it is not allowed
        pass
--- a/tests/forms/test_subtitles_TOWRITE.py
+++ b/tests/forms/test_subtitles_TOWRITE.py
@ -0,0 +1,9 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test that adding a subtitle works for a video - needs to have a language set on Admin
        pass
--- a/tests/notifications/test_check_comment_add_TOWRITE.py
+++ b/tests/notifications/test_check_comment_add_TOWRITE.py
@ -0,0 +1,9 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # add comment, check user is notified
        pass
--- a/tests/notifications/test_check_media_add_TOWRITE.py
+++ b/tests/notifications/test_check_media_add_TOWRITE.py
@ -0,0 +1,10 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # add media, check on mailbox that admins are notified
        pass
--- a/tests/notifications/test_reported_media_add_TOWRITE.py
+++ b/tests/notifications/test_reported_media_add_TOWRITE.py
@ -0,0 +1,10 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # report media, check on mailbox that admin/user are notified
        pass
--- a/tests/pages/test_index_page_TODO.py
+++ b/tests/pages/test_index_page_TODO.py
@ -0,0 +1,11 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # check that all links exist, on anonymous user
        # check that all links exist, on logged in user, plus the user specific
        # for editor/manager/admin, check that the related links exist
        pass
--- a/tests/pages/test_manage_pages_TODO.py
+++ b/tests/pages/test_manage_pages_TODO.py
@ -0,0 +1,9 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # check that links exist from index page and pages are loading and only admins/editors/managers can see them
        pass
--- a/tests/settings/test_portal_workflow_TOWRITE.py
+++ b/tests/settings/test_portal_workflow_TOWRITE.py
@ -0,0 +1,11 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test what is the default portal workflow
        # change it and make sure nothing strange happens (public/unlisted/private)
        pass
--- a/tests/settings/test_user_roles_TOWRITE.py
+++ b/tests/settings/test_user_roles_TOWRITE.py
@ -0,0 +1,13 @@
 from django.test import TestCase
 class TestX(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_X(self):
        # test extra things editor can do
        # test extra things manager can do
        # test extra things admin can do
        # test what single user cannot do (eg mess with other users content!)
        pass
--- a/tests/test_fixtures.py
+++ b/tests/test_fixtures.py
@ -0,0 +1,35 @@
 from django.test import TestCase
 from files.models import Category, EncodeProfile
 class TestFixtures(TestCase):
    fixtures = ["fixtures/categories.json", "fixtures/encoding_profiles.json"]
    def test_categories_fixtures(self):
        categories = Category.objects.all()
        self.assertEqual(
            categories.count(),
            6,
            "Problem with category fixtures",
        )
        categories = Category.objects.filter().order_by('id')
        self.assertEqual(
            categories.first().title,
            'Art',
            "Problem with category fixtures",
        )
    def test_encodeprofile_fixtures(self):
        profiles = EncodeProfile.objects.all()
        self.assertEqual(
            profiles.count(),
            21,
            "Problem with Encode Profile fixtures",
        )
        profiles = EncodeProfile.objects.filter(active=True)
        self.assertEqual(
            profiles.count(),
            6,
            "Problem with Encode Profile fixtures, not as active as expected",
        )