Skip to content
Open
Changes from 1 commit
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
091a89a
Add Create a backend add-on section in the Developer guide.
stevepiercy Nov 6, 2024
a766f5a
- Update meta information
stevepiercy Nov 6, 2024
d8e135c
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Nov 6, 2024
ed9c4af
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Nov 8, 2024
13b85f7
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Nov 18, 2024
0f7a455
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Nov 19, 2024
7767c8b
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Dec 5, 2024
9d9994f
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Feb 9, 2025
3119199
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Feb 26, 2025
dcc8b32
Merge branch '6.0' into dev-guide-create-a-backend-add-on
petschki Nov 25, 2025
67b1ee7
create backend addon documentation
petschki Nov 25, 2025
0cad2b0
create genericsetup documentation
petschki Nov 25, 2025
042ff32
remove note
petschki Nov 25, 2025
aad7b71
Use file markup
stevepiercy Nov 26, 2025
df7340f
Revert changes in i18n and glossary to keep PR focused on GenericSetup
stevepiercy Nov 27, 2025
6af80fc
Revert changes in i18n and glossary to keep PR focused on GenericSetup
stevepiercy Nov 27, 2025
8579a16
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Dec 1, 2025
2675e11
Update docs/developer-guide/create-a-backend-add-on.md
petschki Dec 1, 2025
6e92377
remove plonecli addon creation and note for monorepo "make" command
petschki Dec 1, 2025
0a4cace
only mention "make" command for "cookieplone" generated addons
petschki Dec 1, 2025
132f1be
Update docs/developer-guide/create-a-backend-add-on.md
petschki Dec 9, 2025
2fe88be
Merge branch '6.0' into dev-guide-create-a-backend-add-on
MrTango Jan 14, 2026
bb795bc
explain how to create a backend-addon with plonecli only.
petschki Jan 15, 2026
3db83f5
minor command fix
petschki Jan 15, 2026
a7b0d43
Merge branch '6.0' into dev-guide-create-a-backend-add-on
stevepiercy Feb 9, 2026
096109d
Begin editorial clean up
stevepiercy Feb 9, 2026
a0358f1
Merge branch '6.0' into dev-guide-create-a-backend-add-on
petschki Feb 20, 2026
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
Prev Previous commit
Next Next commit
remove plonecli addon creation and note for monorepo "make" command
  • Loading branch information
petschki committed Dec 1, 2025
commit 6e92377e352849a187edf74aef21c73562a2eba7
78 changes: 4 additions & 74 deletions docs/developer-guide/create-a-backend-add-on.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,80 +99,6 @@ Cookieplone creates a folder with the name of the add-on, in this example, `coll
You can now continue to add subtemplates to your addon {ref}`create-a-backend-add-on-add-subtemplate-label`


## Generate the add-on project with `plonecli`

Run the following command to create an addon project with `plonecli`

```shell
uvx plonecli create addon <addon namespace package>
```

```console
> uvx plonecli create addon collective.addon
RUN: bobtemplates.plone:addon -O collective.addon

Welcome to mr.bob interactive mode. Before we generate directory structure,
some questions need to be answered.

Answer with a question mark to display help.
Values in square brackets at the end of the questions show the default value if
there is no answer.


--> Package description [An add-on for Plone]:

--> Plone version [6.0.0]:

--> Python version for virtualenv [python3]:

--> Do you want me to activate VS Code support? (y/n) [y]:



isort-apply: successful:
isort-apply: install_deps> python -I -m pip install isort -c constraints.txt
isort-apply: commands[0]> isort /Users/<username>/Development/collective.addon/src
/Users/<username>/Development/collective.addon/setup.py
Fixing /Users/<username>/Development/collective.addon/src/collective/addon/testing.py
Fixing /Users/<username>/Development/collective.addon/src/collective/addon/tests/test_setup.py
isort-apply: OK (2.57=setup[1.94]+cmd[0.63] seconds)
congratulations :) (2.59 seconds)


Identified `/` as project root containing a file system root.
Sources to be formatted: "Users/<username>/Development/collective.addon/src",
"Users/<username>/Development/collective.addon/setup.py"
src/collective/__init__.py wasn't modified on disk since last run.
src/collective/addon/browser/__init__.py wasn't modified on disk since last run.
src/collective/addon/locales/__init__.py wasn't modified on disk since last run.
src/collective/addon/tests/__init__.py wasn't modified on disk since last run.
src/collective/addon/interfaces.py already well formatted, good job.
reformatted src/collective/addon/__init__.py
reformatted src/collective/addon/setuphandlers.py
reformatted src/collective/addon/testing.py
reformatted setup.py
reformatted src/collective/addon/locales/update.py
reformatted src/collective/addon/tests/test_setup.py

All done! ✨ 🍰 ✨
6 files reformatted, 5 files left unchanged.

black-enforce: successful:
black-enforce: install_deps> python -I -m pip install black -c constraints.txt
black-enforce: commands[0]> black -v src setup.py
black-enforce: OK (2.60=setup[2.12]+cmd[0.48] seconds)
congratulations :) (2.61 seconds)


git init is disabled!
Generated file structure at /Users/<username>/Development/collective.addon/collective.addon
```

Plonecli creates a folder with the name of the add-on, in this example, `collective.addon`.

You can now continue to add subtemplates to your addon {ref}`create-a-backend-add-on-add-subtemplate-label`


(create-a-backend-add-on-add-subtemplate-label)=

## Add `plonecli` subtemplate to an addon
Expand Down Expand Up @@ -216,6 +142,10 @@ Available mr.bob templates:
uvx plonecli add <subtemplate>
```

```{note}
When you have created a project with `cookieplone`, then you can simply do `make add <subtemplate>` inside the {file}`backend` folder.
```

Currently documented subtemplates:

- behavior: {ref}`backend-behaviors-label`
Expand Down
Loading