1. Introduction – Volto Add-ons Development

1. Introduction#

1.1. Who are you?#

Tell us about yourselves:

  • Name, company, country...

  • What is your Plone experience?

  • What is your JavaScript experience?

  • What is your Volto experience?

  • What are your expectations for this hands-on session?

1.2. What will we do?#

Some technologies and tools we use during the training:

This training assumes that you have already taken (either in person at a Plone Conference or online) the existing React and Volto trainings. If you're following this training course on your own, you should first go through the Volto Hands-On training.

In a real training the instructor should quickly go through a number of key concepts of React and Volto development, as a refresher.

1.3. What to expect#

At the end of this course you will know how to extend Volto using add-ons, what are the current capabilities of add-ons, their pros and cons, how to distribute add-ons and how to deploy them.

1.3.1. Roadmap#

  • bootstrap a Volto project using the @plone/volto skeleton generator

  • bootstrap a Volto add-on from scratch

  • develop a simple Volto block

  • write an action/reducer pair for network requests

  • connect the block to network-fetched async data

  • learn how to make React code reusable

  • learn how to make blocks extensible

1.4. The hands-on exercise#

The hands-on exercise will feature developing an add-on that provides table views for data files (CSV). We will be using real-world patterns and development models based on the experience gained while developing several websites that use these types of add-ons.

Here's a preview of the block we'll build:

../_images/final-block.png

We will be facing different challenges, and we will be solving them, introducing or refreshing some concepts covered in the previous training classes. We will cover the proper solution to each challenge, and we will provide an overview of what to expect when developing for Volto.

1.5. Before you start#

You'll need to have a Plone instance with plone.restapi integrated. The quickest way to get a Plone instance running is with Docker:

docker run -it --rm --name=plone \
  -p 8080:8080 -e SITE=Plone -e ADDONS="plone.volto" \
  -e ZCML="plone.volto.cors" \
  -e PROFILES="plone.volto:default-homepage" \
  plone

If you have the whole tool chain setup to develop Plone, you can also clone and use Volto's development backend setup:

git clone https://github.com/plone/volto
cd volto
make build-backend
make start-backend