2.2.7 Content droplets

Revision as of 10:39, 7 December 2023

ContentDroplets is available from BlueSpice 4.3.2.

Adding a droplet to a page

To add a droplet to a page:

Click the Content droplets icon in the editor toolbar or type <<.
Search for a droplet name in the search bar of the droplets menu or browse the droplets by category.
Select a droplet
Click Insert.

Note:Some droplets open an inspector menu which contains another Insert button. Be sure to confirm that button as well.

Based on the type of droplet, you can continue with configuring the droplet as needed.

List of droplets

View examples of droplets outputs.

Droplet	Description	Inserts the following in the page source:
Attachments Attachments output	Area for organising attachments	`<attachments title="Attachments area">` `* [[Media:Financial_Sample.xlsx]]` `</attachments>`
Booklist	List of books based on a filter value. The value needs to be defined as a metadata value in the book settings.	`<bs:booklist filter="Author:WikiSysop" />`
Book PDF link v4.4+	PDF-download link to a book	`{{BookPDFLink\|book=Testbook\|template=BlueSpice%20Book\|label=Book PDF Link}}`
Book table of contents v4.4+	Inserts the ToC of any book in a wiki page.	`Book Testbook doesn't exist`
BPMN diagram BPMN diagram	Editable BPMN diagram	`<bpmn name="Test:Erm31642" />`
Button Links styled as buttons	Link that is styled as a button	`{{ButtonLink\|target=Main Page\|label=click me!\|format=blue}}`
Categorytree	Selected categories are shown in a tree structure	`<categorytree>TestCat</categorytree>`
Checkbox -v4.3	Checkbox that can be checked in view mode	`<bs:checkbox checked="true" />`
Checklist	List that allows to set a value in view mode	`<bs:checklist type="list" checked="true" list="Template:Status" value="Select status" />`
Chemical formula Chemical formula	Display of chemical formulas	`<chem>H2O</chem>`
Circled number	Number in a circle with customizable color	`{{CircledNumber\|bgColor=black\|fgColor=yellow\|number=180}}`
Code Code area for a css example	Highlighted section for code examples	`<syntaxhighlight lang="css">` `.hi {background:blue;}` `</syntaxhighlight>`
Create page	Form field for predefined page creation	`{{CreateInput\|alignment=left\|buttonlabel=Create}}`
Data query	Enables queries on content in the wiki	`<dataquery modified="+" format="ul" count="6" namespaces="Main" />`
Date v4.4+ Date display	Inserts a date. This can be used in combination with the content droplet Task list	`23 November 2023`
Decision Decision output	Highlights a decision as a page property	`{{Decision\|decision=Eat more veggies}}{{Decision\|decision=Buy new car}}`
Decision overview Decision report output	table with a list of decisions that were created by the Decision content droplet	`<decisionoverview namespaces=""></decisionoverview>`
Diagram Drawio diagram	Editable draw.io diagram	`<drawio filename="Mydiagram">`

More info

Technical Reference: ContentDroplets

To submit feedback about this documentation, visit our community forum.

@@ Line 20: / Line 20: @@
 ! style="background-color:rgb(234, 236, 240);text-align:center;width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);padding:8px;" class="" |'''Description'''
 !Inserts the following in the page source:
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Attachments]] {{PopImg|file=attachments.png|alt=Screenshot of the attachments area|caption=Attachments output|width=600}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Area for organising attachments
+|<code><nowiki><attachments title="Attachments area"></nowiki></code>
+<code>* <nowiki>[[Media:Financial_Sample.xlsx]]</nowiki></code>
+<code><nowiki></attachments></nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Booklist
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of books based on a filter value. The value needs to be defined as a metadata value in the book settings.
+|<code><nowiki><bs:booklist filter="Author:WikiSysop" /></nowiki></code>
+|-
+|Book PDF link{{Bsvs|bsvFrom=4.4}}
+|PDF-download link to a book
+|<code><nowiki>{{BookPDFLink|book=Testbook|template=BlueSpice%20Book|label=Book PDF Link}}</nowiki></code>
+|-
+|Book table of contents{{Bsvs|bsvFrom=4.4}}
+|Inserts the ToC of any book in a wiki page.
+|<code><booknav book="Testbook" chapter="1" /></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[mediawikiwiki:Extension:Cognitive_Process_Designer#Usage|BPMN diagram]] {{PopImg|file=Manual:bpmn-UserFeedback.svg|alt=Screenshot of a BPMN diagram|caption=BPMN diagram|width=600}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Editable BPMN diagram
+|<code><nowiki><bpmn name="Test:Erm31642" /></nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/ButtonLink|Button]]{{PopImg|file=HW-ButtonLink.png|alt=Screenshot of three colored button links|caption=Links styled as buttons|width=400}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Link that is styled as a button
+|<code><nowiki>{{ButtonLink|target=Main Page|label=click me!|format=blue}}</nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[mediawikiwiki:Extension:CategoryTree|Categorytree]]
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Selected categories are shown in a tree structure
+|<code><nowiki><categorytree>TestCat</categorytree></nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceChecklist#Creating a checkbox|Checkbox]]{{Bsvs|bsvTo=4.3}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Checkbox that can be checked in view mode
+|<code><nowiki><bs:checkbox checked="true" /></nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceChecklist|Checklist]]
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List that allows to set a value in view mode
+|<code><nowiki><bs:checklist type="list" checked="true" list="Template:Status" value="Select status" /></nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[wikipedia:Help:Displaying_a_formula#Chemistry|Chemical formula]]  {{PopImg|file=chem.png|alt=screenshot of the chemical formula|caption=Chemical formula|width=300}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Display of chemical formulas
+|<code><nowiki><chem>H2O</chem></nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Circled number
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Number in a circle with customizable color
+|<code><nowiki>{{CircledNumber|bgColor=black|fgColor=yellow|number=180}}</nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:SyntaxHighlight|Code]]{{PopImg|file=syntaxhighlight.png|alt=Screenshot of a code area with css syntax|caption=Code area for a css example}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Highlighted section for code examples
+|<code><nowiki><syntaxhighlight lang="css"></nowiki></code>
+<code>.hi {background:blue;}</code>
+<code><nowiki></syntaxhighlight></nowiki></code>
+|-
+| style="width:190px;" |[[Manual:Extension/InputBox|Create page]]
+| style="width:380px;" |Form field for predefined page creation
+|<code><nowiki>{{CreateInput|alignment=left|buttonlabel=Create}}</nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[SMW queries#Content droplet .22Data query.22 v4.3.2B|Data query]]
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Enables queries on content in the wiki
+|<code><nowiki><dataquery modified="+" format="ul" count="6" namespaces="Main" /></nowiki></code>
+|-
+|Date{{Bsvs|bsvFrom=4.4}}{{PopImg|file=ContentDroplets date.png|alt=Screenshot of a date|caption=Date display}}
+|Inserts a date. This can be used in combination with the content droplet ''Task list''
+|<code><datetime>2023-11-23</datetime></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Decision|Decision]]{{PopImg|file=droplet decision.png|alt=Example of a decision|caption=Decision output|width=600}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Highlights a decision as a page property
+|<code><nowiki>{{Decision|decision=Eat more veggies}}{{Decision|decision=Buy new car}}</nowiki></code>
+|-
+|Decision  overview{{PopImg|file=ContentDroplets Decision report.png|alt=Decision report table|caption=Decision report output|width=600}}
+|table with a list of decisions that were created by the ''Decision'' content droplet<br />
+|<code><nowiki><decisionoverview namespaces=""></decisionoverview></nowiki></code>
+|-
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/DrawioEditor|Diagram]] {{PopImg|file=BlueSpice_system_architecture_high_level.drawio.png|alt=Example of a server structure diagram|caption=Drawio diagram|width=600}}
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Editable draw.io diagram
+|<code><nowiki><drawio filename="Mydiagram"></nowiki></code>
 |}