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

Google Slides block for Lesson Plans #127

Open
courane01 opened this issue Sep 25, 2020 · 21 comments
Open

Google Slides block for Lesson Plans #127

courane01 opened this issue Sep 25, 2020 · 21 comments

Comments

@courane01
Copy link
Collaborator

@courane01 courane01 commented Sep 25, 2020

The Training Team has slides for most lesson plans. They still are only found in GitHub. We'd like them to appear within the lesson plan, as a sidebar item.

User stories: https://docs.google.com/document/d/1TrcH09TtNYkwp3W6pI_BzkDnbkwhpw6utFRYuLqCBwg/edit?usp=sharing

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Sep 28, 2020

Are you wanting the slides to be visible on the site itself? Like people can go through them on learn.wordpress.org, or is a downloadable file fine?

@courane01
Copy link
Collaborator Author

@courane01 courane01 commented Oct 2, 2020

Both - and creation of slides. It's part of what it would also take for the team to leave GitHub. It's quite a tangled situation.

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Oct 2, 2020

Could you give more detail about what you want and how you want it to work? Does GitHub currently offer this functionality, which is why you need it in order to fully migrate? The more details you can provide the easier it will be to find an effective solution.

@courane01
Copy link
Collaborator Author

@courane01 courane01 commented Oct 9, 2020

We likely need design involved. There are 85 lesson plans, many of those have accompanying slide decks. The User Stories doc covers the uses. If it'd help to speak via an audio/video chat, I'd be happy to set up a meeting. We have a design template in place, and want consistency for all the presentations. We need a way to create, present, and an option to download and review the slides offline. The plugin mentioned near the end of the doc has a decent working model in place. I realize, it's a huge ask for adding functionality to Learn. The training team is not committed to that plugin that was contributed, but it may be a great start.

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Oct 9, 2020

I'm still not 100% clear on the needs. From what I can tell, you want:

  • The ability to create slides for the lesson plans from with wp-admin
  • The slides to be viewable on the frontend
  • The slides to be downloadable on the frontend (which would require downloading in multiple file formats I presume)

Is that accurate? Are there additional needs here?

The reason I'm asking, is because it really feels like including slide-building functionality on Learn seems like a huge additional thing, when Google Slides (for example) offers all of the above functionality with easy sharing and no conflicts. Is there a reason why having the slide-building be native to the site is important? Or would a third-party platform like Google Slides work?

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Oct 9, 2020

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Oct 9, 2020

Based on the prior discussion, the requirements for the slides platform are:

Backwards compatible
Reusable
Minimal learning curve
Ability to use without internet
Design consistency between different sets of slides (theme)
Maintainability
Ease of updates
Ability to account for different aspect ratios
Accessible
Open source

A native solution (i.e. a WordPress plugin) could be great, but there would be a high maintenance burden involved. I would hate to see a cool solution implemented, but it falls apart a year or two down the line because it cannot be adequately maintained.

Google Slides ticks all of the boxes above except for the different aspect ratios (which can be solved with more than one deck being used) and it's not open-source (which isn't a problem here since its a hosted service).

With that mind, I propose that we go with Google Slides here and, if it ends up being a difficult or problematic platform then we can look into other options. It's safer to start with an existing hosted platform that looks like it should work, rather than build something from scratch that needs to be actively maintained.

Does that sound reasonable? Does anyone see an issue with that? I'm very open to alternatives here, but I do think Google Slides is a good way forward here.

@azhiya
Copy link
Collaborator

@azhiya azhiya commented Oct 16, 2020

I hadn't actually thought about Google slides but it does sound like a reasonable solution.

I'm going to ping the Accessibility team to confirm that there are no issues with this proposed solution.

@azhiya
Copy link
Collaborator

@azhiya azhiya commented Nov 10, 2020

@hlashbrooke how do I add an accessibility label to this issue? Forgive me if it is obvious but my brain isn't computing at the moment.

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Nov 11, 2020

It doesn't look like we have an accessibility label in this repo and I don't have access to create one.

If we're going to go with Google Slides though, then this issue can essentially be closed since that isn't a dev solution.

@courane01
Copy link
Collaborator Author

@courane01 courane01 commented Nov 15, 2020

Training is still not decided on next steps in leaving all that we have in GitHub. Our temporary solution will include linking to slides still in the GitHub repo. As a team, we had voted against Google Slides as it didn't meet the requirements on https://make.wordpress.org/training/handbook/guidelines/slides-style-guide/ (recently found that page). I can't find written text, but believe these guidelines were based off many of the same ideas of WP itself. We have content in GitHub and do not have time to recreate if we are aiming for an announcement with 5.6 release. The team can revisit our needs after launch to figure out our plan.

@courane01
Copy link
Collaborator Author

@courane01 courane01 commented Feb 26, 2021

Update: https://make.wordpress.org/training/2021/01/29/request-for-testing-slides-plugin/

Learn Working Group will review for use in Workshops as well. Then we can escalate to an official request.

@courane01
Copy link
Collaborator Author

@courane01 courane01 commented Mar 5, 2021

We'd like to escalate this now to an official request @coreymckrill. The testing feedback seemed positive.

Considerations:

  • I reached out to Ella but had no response in Slack DMs about hoping to use the plugin
  • We'd like to aim for the mockup where @melchoyce included the slidedeck embedded placeholder. That is not a current feature of the plugin #153 (comment) The embed could play in the lesson or be a redirect to show it by itself in the browser.
  • I left 2 support issues on the plugin to address https://wordpress.org/support/plugin/slide/
  • The plugin is also attributed to the .org account as a dev.
  • Learn Working Group seems open to using this as well, but not restricted to it exclusively.
  • The revision tool (and later audit) will also help us maintain the content to be current.
  • There is a PDF export option built in from the admin editor. Can we provide a front end link that those wanting to download the material could get print option? We could link to some info about how to print to pdf for them. Offline consideration.

What additional info can I share to start the review/consideration?

@andreamiddleton
Copy link

@andreamiddleton andreamiddleton commented Mar 5, 2021

My understanding is that this plugin is not being maintained. Currently, I don't know who might be available to maintain it; Meta is challenged by their maintenance burden as it stands. I believe the slides plugin was created as a proof of concept. Given those givens, I don't think it's a viable solution for Learn/Training.

As a team, we had voted against Google Slides as it didn't meet the requirements on https://make.wordpress.org/training/handbook/guidelines/slides-style-guide/ (recently found that page).

Do you mind if I ask when this vote was held? It might be worth reassessing, if it's been a year or more — products like Google Slides do change and expand their feature set pretty regularly.

Also, I'm not clear on what features from that list are not available via Google Slides; can you help me understand?

@courane01
Copy link
Collaborator Author

@courane01 courane01 commented Mar 8, 2021

The team decision was held years ago. Backstory in the links above. #127 (comment)

As a team, we would like to have a slide presentation for nearly every lesson plan that can be used offline.

We had these started in GitHub. That meant 1 team Repo to maintain and "own" the slides. Using Google Slides, each contributor would own that deck. That presents considerable more effort when upgrading slide decks, including auditing, locating, accessing revision permissions, etc.

Concerns:

  • Maintainability
  • Ease of content updates

Would alternative and maintained slide plugins available in the repo be considered? Untested but notice something that may be similar and has been maintained https://wordpress.org/plugins/presenter/. We could revisit to test if it would be an option.

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Aug 17, 2021

I'd like to circle back here since getting slides on lesson plans would be a great thing to see happen sometime soon.

I poked around and asked the people involved and, right now, none of the slides plugins that are available in the Plugin Directory are being actively maintained and there are no current plans to do so with any of them. That means that we have three options for Learn:

  1. Use a plugin from the directory and hope that the original author puts some work into maintaining it
  2. Fork a plugin from the directory and the Meta team will have to put in the work of maintenance
  3. Use a third-party platform for slides

Option 1 is impractical for obvious reasons.

Option 2 is going to be a tough sell since we have a lot of dev work needed to be done on Learn, and a lot of custom code that already needs to be maintained, that it would be stretching the Meta team unreasonably thin to ask them to maintain an additional large amount of code.

Option 3 feels like the only realistic solution out of these and, when it comes to third-party solutions, the best option is Google Slides (although I'm very much open to other suggestions if they're workable). Google Slides ticks all of the boxes for what is needed (highlighted in comments above), but I understand the hesitancy here and can see some issues with using Google Slides, namely:

  • Individual contributors would need special access in order to keep content up to date
  • There's no simple way of embedding a Google Slides presentation in WordPress that does everything we need

To mitigate those issues to some degree I propose the following:

  1. We host all slide decks on a central Google account - the WP Foundation G Suite setup could be used for this, so it would simply be a matter of sharing the login details with the people involved. This would provide a central home for all slide decks, rather than having them on individual people's accounts.
  2. We open a new issue for a block to be built for Learn that embeds the slide deck on the frontend, as well as provides a link to the presentation on google.com. That way people can see the slides in context and open them full screen to use them right there, or they can go to the source directly and download them in a variety of formats (PDF, PPT, ODP, etc.). This block would be easy to build and would not result in a maintenance burden for the Meta team.

Does that sound reasonable? I'm aware the best solution would be one that is native to WordPress and can be managed inside the WP dashboard, but right now that just doesn't exist in any sort of maintainable and realistic way, so I feel like what I have proposed here is the most practical solution that could actually be implemented.

@azhiya
Copy link
Collaborator

@azhiya azhiya commented Aug 17, 2021

Thanks for looking into this Hugh. A few questions:

  • If the template is updated, is this automatically reflected on all the slide decks that have already been created or will we have to manually update each slide deck?
  • Since Google slides only uses fixed ratios, does this mean that contributors will need to create at least 3 different slides decks for each lesson plan?
  • With regard to option 2, would it be worth approaching a 5FTF company to provide additional resources for the meta team?

@binarygary
Copy link

@binarygary binarygary commented Aug 17, 2021

I'm adding some context notes.
If you, like me, remembered that State of the Word at WCUS in 2019 slides were presented in the block editor/gutenberg and wanted to suggest that as a solution you can stop your research here.
The plugin utilized to support the SOTW WCUS 19 slides is the first link referenced here #127 (comment) and is no longer supported. As noted in #127 (comment) this plugin will not likely be a good solution here.

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Aug 17, 2021

Thanks for highlighting that @binarygary!

To answer your questions @azhiya:

  • I'm not sure about the templates, but I can definitely do some research there to see how effectively that would work.
  • Regarding aspect ratios - if we want slides in different aspect ratios then yes, there would need to be multiple versions of the same deck. I agree that wouldn't be ideal, so if we go this route do you think it's worth having a discussion about whether we actually need them to be in different aspect ratios? I know people have different size screens/projectors, but ultimately an incorrect aspect ratio doesn't seem like a major issue to me, but there's a very good chance that I haven't considered all the ramifications of it.
  • That's unlikely since the dev cost wouldn't just be for building, but for the long tail of ongoing maintenance that the core team would have to take on. Especially since we have so many other dev needs for Learn that would make more sense to contribute people towards.

I'm definitely keen to explore options here, so if there's something that will work better than Google Slides please suggest it!

@hlashbrooke
Copy link
Collaborator

@hlashbrooke hlashbrooke commented Aug 25, 2021

As per the discussion in this week's Training Team meeting, we're going to move forward with Google Slides and evaluate that as we go along.

With that in mind, the needs of this issue have changed to require the following:

  • A new block that can take two inputs - one for the published slides URL and one of the slide edit URL
  • On the frontend this block will display the slides embedded in the iframe provided by Google Slides along with the link to the edit URL
  • The block must be added to the lesson plans post template

I'll update the issue title to reflect this change.

@hlashbrooke hlashbrooke changed the title Slides on Lesson Plans Google Slides block for Lesson Plans Aug 25, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
6 participants