Upgrading and evolving the WPTV form to upload videos

[MaximeCulea]

A bit of context, as a WordCamp organizer, we came across a lack of documentation (​https://make.wordpress.org/tv/handbook/aws/upload-s3/) about the process of uploading videos for WPTV which is not up to date anymore.

So to ease the process of uploading videos (for a WordCamp), the documentation will be updated, but most of it, I propose to evolve the form (​https://wordpress.tv/submit-video/) and connect it to WordCamp sites to automagically get the following fields:

• WordCamp event
• Session info
• Session could lead to speaker info as well

The user could tweak the fields if necessary, remaining only to upload the file for the video.

The idea is to minimize errors and facilitate the form submission, especially when uploading 10-15 videos for a WordCamp.

[MaximeCulea]

Note: It's not related to https://meta.trac.wordpress.org/ticket/1429 even if we talk about form improvements.

[dd32]

#1429 and this go hand in hand IMHO.

The way I envisioned it:

• WordCamp selection list, possibly pulled from the WordCamp central wp-json API
• Upon selecting the WordCamp, fetch the sessions / speakers details via site-specific wp-json
• Upon session selection, auto-fill the fields on the upload form with those details.

The above would be purely client-side javascript.

We could add extra fields on the WordPress.TV side to store any additional metadata needed, such as the Session that it was imported from, or the WordCamp Twitter account (to fill in the Event Term metadata)

I'm not sure if the WordCamp API's expose all that's needed, but if not, adding public data can be easily added.

[sippis]

Some API addresses taht are probably helpful :)

• WordCamps ​https://central.wordcamp.org/wp-json/wp/v2/wordcamps
• Sessions ​https://europe.wordcamp.org/2022/wp-json/wp/v2/sessions
• Speaker details ​https://europe.wordcamp.org/2022/wp-json/wp/v2/speakers/10057

In case more details are needed in those endpoints, open an issue on the WordCamp.org Github repository. I'm happy to help on that side if/when needed!

[dd32]

Additionally, if required, we could separate the WordCamp submission page into a separate form from ​https://wordpress.tv/submit-video/ (ie. ​https://wordpress.tv/submit-video/wordcamp/) so as to streamline the submission process.

That would require some WordPress.tv alterations, but shouldn't be significantly more work.

[MaximeCulea]

From the current form, things will go like that:

1. We still tick "This is a WordCamp video" changing the form to allow to communicate with the WordCamp APIs.

2. Deleted fields

• Category is deleted because since it's a WordCamp video, it will be "WordCampTV" by default.

3. Existing fields that still need to be filled:

• Uploaded by (as required): Uploader's WP username
• Email address (as required): Uploader's email
• Producer WordPress.org Username: Video producer's WP username
• Language: WordCamp can have multiple languages such as Geneva in French and English. Also, to facilitate how all videos are ordered, we will have to display a multi-select field with all available languages.

4. Fields that wont't show but will get automatically from APIs:

• Video title: ​https://geneve.wordcamp.org/2022/wp-json/wp/v2/sessions/5221 -> title->rendered
• Date recorded: ​https://geneve.wordcamp.org/2022/wp-json/wp/v2/sessions/5221 -> date
• Location: ​https://central.wordcamp.org/wp-json/wp/v2/wordcamps/3143150 -> location
• Speakers: ​https://geneve.wordcamp.org/2022/wp-json/wp/v2/sessions/5221 -> session_speakers->name
• Event: ​https://central.wordcamp.org/wp-json/wp/v2/wordcamps/3143150 -> title->rendered
• Description: ​https://geneve.wordcamp.org/2022/wp-json/wp/v2/sessions/5221 -> excerpt->rendered (which can be overwritten by excerpt or it's the beginning of the content)
• Slides URL: ​https://geneve.wordcamp.org/2022/wp-json/wp/v2/sessions/5221 -> meta->_wcpt_session_slides

5. New fields that need to be created (with API)

• WordCamp selector (from API)
• Session selector (from API)

So the uploader has to select the WordCamp bringing the Sessions and select one. This will populate all fields from point 4.

Note: here is the WPTV theme: ​https://github.com/WordPress/wordpress.org/tree/trunk/wordpress.tv/public_html/wp-content/themes/wptv2

[SergeyBiryukov]

Related: #6344

[wplmillet]

I think that for the language field, we need to build on what has already been validated previously. Basically, make a select that uses the list of languages validated in previously published videos as a reference list. With this method, the creation of new languages relies on the administrators and moderators. If, during the validation of a video, a moderator sees that a language proposal is wrong, he or she can correct it and the wrong proposal will no longer be proposed in the select of the submission form. However, I don't know if this value can be called up via an API.