Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Conferences #181

Open
wants to merge 8 commits into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/en/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@
**** xref:admin:spaces/assemblies/moderations.adoc[Moderations]
*** xref:admin:spaces/initiatives.adoc[Initiatives]
*** xref:admin:spaces/conferences.adoc[Conferences]
**** xref:admin:spaces/conferences/conference_creation.adoc[Conference creation]
**** xref:admin:spaces/conferences/components.adoc[Components]
**** xref:admin:spaces/conferences/categories.adoc[Categories]
**** xref:admin:spaces/conferences/attachments.adoc[Attachments]
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/en/modules/admin/assets/images/spaces/conferences/menu.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
192 changes: 52 additions & 140 deletions docs/en/modules/admin/pages/spaces/conferences.adoc
Original file line number Diff line number Diff line change
@@ -1,169 +1,81 @@
= Conferences

== Understand the basics

A conference is a collection of meetings arranged in a program, with a number of people invited as speakers, and other
information fields typical of large congresses or social events (registration, list of organizations that support or sponsor the
event, etc.). A conference can be a relevant event for an organization and its members, or take place as part of a participatory
event, etc.) A conference can be a relevant event for an organization and its members, or take place as part of a participatory
process or follow a consultation.

Examples:

* A general assembly for an organization
* The annual meeting of a cooperative

As a real world example you can see the anual Metadecidim conferences:

image:spaces/conferences/example01.png[Decidim Fest 2020]

* https://meta.decidim.org/conferences/decidimfest19[Decidim Fest 2019]
* https://meta.decidim.org/conferences/decidimfest2020[Decidim Fest 2020]
* https://meta.decidim.org/conferences/DecidimFest21[Decidim Fest 2021]

== Create a new conference

For adding a new conference, you need to:

image:spaces/conferences/menu.png[Conferences menu]

. Sign in as admin
. Go to admin panel
. In the main sidebar, click in the button "Conferences"
. Click in the button "Create a new conference"
. Configure the conference by filling the form

image:spaces/conferences/new_conference.png[Create a new conference form]

.Create a new conference
|===
|Field |Type |Description

|Title
|Required
|What is the title of this conference. For instance "Decidim Fest 2021"
In conferences, meetings components are displayed in a program form, with days and hours being listed like in an event program.

|Slogan
|Required
|A subtitle for this conference. For instance, "Democracy, Technology and Global Justice"
NOTE: You want to create a conference? Check the xref:admin:spaces/conferences/conference_creation.adoc[conference creation] article.

|URL slug
|Required
|URL slugs are used to generate the URLs that point to this conference. Only accepts letters, numbers, and dashes, and
must start with a letter. Example: if your domain is 'example.org' and your slug 'DecidimFest21' then your URL will be
https://example.org/conferences/DecidimFest21
In this documentation section, you can find how to configure and manage all of those items:

|Hashtag
|Optional
|Hashtag for Twitter
* xref:admin:spaces/conferences/conference_creation.adoc[Conference creation]
* xref:admin:spaces/conferences/components.adoc[Components]
* xref:admin:spaces/conferences/categories.adoc[Categories]
* xref:admin:spaces/conferences/attachments.adoc[Attachments]
* xref:admin:spaces/conferences/media_links.adoc[Media Links]
* xref:admin:spaces/conferences/partners.adoc[Partners]
* xref:admin:spaces/conferences/speakers.adoc[Speakers]
* xref:admin:spaces/conferences/registrations.adoc[Registrations]
** xref:admin:spaces/conferences/registrations/types.adoc[Registration Types]
** xref:admin:spaces/conferences/registrations/users.adoc[User Registrations]
** xref:admin:spaces/conferences/registrations/invites.adoc[Invites]
** xref:admin:spaces/conferences/registrations/certificates.adoc[Certificate of Attendance]
* xref:admin:spaces/conferences/admins.adoc[Conference admins]
* xref:admin:spaces/conferences/moderations.adoc[Moderations]

|Highlighted
|Optional
|Should this conference be more prominent than others? For instance, is this an ongoing or a conference that has happened years ago?
== How to find it?

|Short description
|Required
|A short explanation of what's your conference about.
To access the Conferences panel, go in the administration panel and click the "Conferences" item in the administration
navigation bar.

|Description
|Required
|A long explanation of what's your conference about.
image::spaces/conferences/menu.png[Conferences menu]

|Objectives
|Optional
|What are the objectives or goals for this conference?
There, you are able to manage all existing conferences.

|Location
|Optional
|Where will this conference take place?
== Manage processes

|Home image
|Optional
|Preferrably a landscape image that does not have any text. The service crops
the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png
image::spaces/conferences/manage_conferences.png[Conferences list in administration panel]

|Banner image
|Optional
|Preferrably a landscape image that does not have any text. The service crops
the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png
You can find all the conferences on the list in the administration panel, with:

|Scopes enabled
|Optional
|Check if you want to have Scopes filtering in this conference
* *Title*: title of the conference.
* *Created at*: date of creation of the conference.
* *Published*: if the conference is published or no.

|Scope
|Optional
|Which xref:admin:scopes.adoc[Scope] does this conference belongs to.
You can filter and sort this list by clicking the "Filter" button and the columns headers.
You can also search for conferences by their title in the search bar.

|Show statistics
|Optional
|Check if you want to show the Statistics section.

|Start date
|Required
|When will this conference start. Expected format: dd/mm/yyyy

|End date
|Required
|When will this conference end. Expected format: dd/mm/yyyy

|Registrations enabled
|Optional
|Check if you want to handle registrations on the platform.

|Available slots
|Optional
|Leave it to 0 if you have unlimited slots available.

|Registration terms
|Required if "Registrations enabled" is checked
|What are the terms of service or conditions that a participant must accept for registering in this conference?

|Related participatory processes
|Optional
|Select the processes that are related to this conference. Use the *ctrl* function to select more than one option.

|Related Assemblies
|Optional
|Select the assemblies that are related to this conference. Use the *ctrl* function to select more than one option.

|Related Consultations
|Optional
|Select the consultations that are related to this conference. Use the *ctrl* function to select more than one option.
== Actions

|===
|Icon |Name |Definition

## Creating the program

For creating the program of the conference you need to create a new xref:components/meetings.adoc[Meeting component] with the
dates and times of the different talks, workshops, sessions, etc. After publishing the meetings, it will be visible in the landing page
and there'll be a special navigation for these meetings so they're ordered by date and time.
|image:icons/action_edit.png[Configure conference icon]
|Configure
|To edit the configuration and components for a conference.

image:spaces/conferences/program_frontend.png[Conferences program (frontend)]
|image:icons/action_duplicate.png[Duplicate conference icon]
|Duplicate
|To duplicate this conference.

image:spaces/conferences/program_backend.png[Conferences program (backend)]
|image:icons/action_preview.png[Preview conference icon]
|Preview
|Preview of how the conference looks in the user interface.

Also if you they are "In person" meetings with a location then you'll have a list of the venues.
|image:icons/action_moderate.png[Moderate conference icon]
|Moderate
|To access the conference moderation panel.

image:spaces/conferences/program_venues_frontend.png[Conferences venues (frontend)]

## Menu

image:spaces/conferences/manage_conferences.png[Conferences list at admin panel]
|===

After you’ve initially created your conference you have a submenu where you need
to keep configuring more information about it.
== Examples

image:spaces/conferences/sidebar.png[Conferences sidebar]
Below, you can find some links to examples conferences:

. Info: the same form that we explained in this page.
. xref:admin:spaces/conferences/components.adoc[Components]
. xref:admin:spaces/conferences/categories.adoc[Categories]
. xref:admin:spaces/conferences/attachments.adoc[Attachments]
. xref:admin:spaces/conferences/media_links.adoc[Media Links]
. xref:admin:spaces/conferences/partners.adoc[Partners]
. xref:admin:spaces/conferences/speakers.adoc[Speakers]
. xref:admin:spaces/conferences/registrations.adoc[Registrations]
.. xref:admin:spaces/conferences/registrations/types.adoc[Registration Types]
.. xref:admin:spaces/conferences/registrations/users.adoc[User Registrations]
.. xref:admin:spaces/conferences/registrations/invites.adoc[Invites]
.. xref:admin:spaces/conferences/registrations/certificates.adoc[Certificate of Attendance]
. xref:admin:spaces/conferences/admins.adoc[Conference admins]
. xref:admin:spaces/conferences/moderations.adoc[Moderations]
* https://meta.decidim.org/conferences/DecidimFest24[Decidim Fest 2024]
* https://barcelonadema-participa.cat/conferences/jornada-resilient[Resilient metropolis initial day of the Strategic plan of the Barcelona metropolis]
79 changes: 1 addition & 78 deletions docs/en/modules/admin/pages/spaces/conferences/attachments.adoc
Original file line number Diff line number Diff line change
@@ -1,79 +1,2 @@
= Attachments

Attachments allow an administrator to upload static files to a conference.

When a conference is launched, it is important to provide citizens with as much information as possible about them so
that they can participate with knowledge. That is why it is helpful to add files (Attachments) with the information that
is considered relevant.

Optionally, these documents can be grouped in *Folders*.

They can be found on the Conference "Media and links" section:

image:spaces/conferences/attachments.png[Conferences attachments (backend)]

image:spaces/conferences/media_links_frontend.png[Conferences attachments (frontend)]

Read more about this in xref:admin:spaces/conferences/media_links.adoc[Media links].

== Create a new attachment

image:spaces/attachments_admin.png[View the attachments of a conference in the admin interface]

For creating a new phase of a conference:

. Sign in as administrator
. Go to the conference section in the sidebar
. Click on the conference Edit action
. Click on the Attachments link in the sidebar
. Click on the "New attachment" button

image:spaces/attachments_new_form.png[Create a new attachment form]

.Create attachment
|===
|Field |Type |Description

|Attachment or image name
|Required
|What is the title for this attachment.

|Weight
|Optional
|Which order will it have in relation to the other attachments. Having a lower number means a higher priority. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering.

|Description
|Required
|A long description explaining what this file is about.

|Folder
|Optional
|Which folder this attachment belongs to.

|File
|Required
|Upload the file. Guidance for file: Has to be an image or a document. For images, use preferrably landscape images, the
service crops the image. For CSV files, the separator between columns must be a comma (","). Maximum file size: 10MB. Allowed
file extensions depends in your server configuration.
|===

== Create a new folder

image:spaces/attachments_new_folder_form.png[Create a new folder for attachments form]

.Create folder
|===
|Field |Type |Description

|Name
|Required
|Name of the folder

|Weight
|Optional
|Which order will it have in relation to the other folders. Having a lower number means a higher priority. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering.

|Description
|Required
|A long description explaining what this folder is about.
|===
include::partial$page_attachments.adoc[]
Loading
Loading