- Insert the debate space
- Insert the debate summary on your pages
- Register your site on Logora by signing up : Register
- Get your shortname available on your administration space in the following tab: Configuration > General.
- Authorize the domains on which you want to install Logora. To do this, go to your administration space in the following tab: Configuration > General > Security > Authorized domains.
For example, if the code is inserted on the page at the URL https://example.com/article/example-article, add the domain https://example.com (warning: do not put a slash at the end). Example: http://localhost:3000 , http://sous-domaine.exemple.com. Important: adding domains on the administration space works like adding a tag, don't forget to press "enter" when inserting your URLs.
The debate space is the main platform where your users will be able to participate in debates. The debate space is inserted on a dedicated page on your site.
Let's take the example of a website available at https://yourwebsite.com. The website editor would like to access the debate space via the address https://yourwebsite.com/debate-space. Here are the steps to follow to insert the debate space :
Create a dedicated page where the debate space will be inserted. This page is available at https://yourwebsite.com/debate-space. The prefix 'debate-space' is the default prefix. It can be changed in the administration area.
The logora_app container is where the debate space is loaded.
Standard code to copy/paste and complete:
Use URL rewriting on your platform or CMS to make paths starting with 'debate-space/' (or whatever prefix you choose) point to the page where the debate space is inserted.
Go to https://yourwebsite.com/debate-space/debates. You are on the Debate Space home page!
To change the prefix and the URL paths of the debate space pages, go to the URL paths configuration.
If you prefer to insert the server-side summary, go to the [server-side installation] page (installation/api.md).
The logora_synthese container is the place where the synthesis is loaded.
Standard code to copy/paste and complete :
debate.identifier (required) : unique identifier linked to the page. This identifier must be unique for each page where the synthesis is inserted. It will allow you to retrieve the debate corresponding to the page. For example, the identifier can be the ID in your database of the article on the page, or a unique slug ('example-identifier').
The debate linked to the page must then be created in the administration area > create a debate, by providing the debate.identifier or by selecting the article concerned in the list of last retrieved articles.
All you have to do now is implement a unique sign-on and customize Logora to launch your first debate.