2.2.7 Content droplets

Revision as of 15:37, 14 November 2023

ContentDroplets is available from BlueSpice 4.3.2.

To insert additional functionality in a wiki page, you can use Content droplets. Content droplets include tags that were previously accessed from Insert > Magic word in the editor toolbar. They also provide access to some templates that are preconfigured in the wiki, such as message boxes.

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

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 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

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

Page Decisions
Manual:Extension/ContentDroplets/Examples implement

Diagram

Drawio diagram

Editable draw.io diagram

<drawio filename="Mydiagram">

Gallery

Displays an image gallery

<gallery>

File:test1.png

File:test.pdf

</gallery>

Icon

Icons template

Inserts an icon

{{Icon|bi bi-arrow-left-circle}}

Important Message

Message of type "important"

Adds colored panel for a important note

{{Textbox|boxtype=important|header=OMG|text=Important|icon=yes}}

Links to this page List of pages that link to this page {{Whatlinkshere|count=5|sort=time|order=DESC}}

List of users logged in Pop-up with a list of all users that are currently logged in <bs:whoisonlinepopup />

Map

Map output with text marker

Locations can be marked on the map

{{Map|Munich ~ Hello there!|Munich, Germany}}

Mathematical formula

Screenshot of a math formula

Display of mathematical formulas

<math>\tfrac{2}{4}</math>

Member list List of members of a wiki group <bs:userlist groups="sysop" count="6" />

Message

A plain message

Adds text panel

{{Textbox|boxtype=neutral|header=|text=SDadad|icon=no}}

Modal button Configurable button which opens a customizable modal dialogue {{ModalDialog|title=I am a dialog|btnLabel=click me!|body=This is the text|footer=hello world}}

Most visited pages List of the most visited wiki pages <bs:toplist count="3" period="-" />

New users List of new users in the wiki <bs:newbies count="4" />

Note Message

Message of type "Note"

Adds colored panel for a note

{{Textbox|boxtype=note|header=|text=sfsadfasfdsdaf|icon=yes}}

Number of characters Shows the number of characters or words in a wiki page <bs:countcharacters />

Number of files Shows the number of all uploaded files <bs:countfiles />

Number of pages Shows the number of pages <bs:countarticles />

Number of users Shows the number of all users <bs:countusers />

Number of users logged in Number of currently logged in users <bs:whoisonlinecount />

Page access

Page access notification banner

Restricts access to the page to the specified groups

<bs:pageaccess groups="sysop" />

PDF link Link that downloads another wiki page as PDF {{PDFLink|page=Main Page|template=BlueSpice|label=PDF Link}}

PDF page break Forces a page break at the set position during PDF export <bs:uepagebreak />

PDF preview Embed preview of a PDF file <pdf height="800">File:Raspberry_pi.pdf</pdf></code>

PDF no export Content within this section is excluded from the PDF export <bs:uenoexport>Don't export this text</bs:uenoexport>

Progress Visualizes progress against given measurement variables <bs:statistics:progress basecount="2" progressitem="OK" width="150" baseitem="Status:" />

Pros and cons

Table for comparing pros and cons

{{ProConList|title-advantages=Advantages|title-disadvantages=Disadvantages|advantages=* It is cheap|disadvantages=* It is sold out}}

Recent changes List of recently changed pages <recentchanges count="6" period="-" sort="time" showns="0" />

Signature

Signatures button

A button to add signatures in view mode

<bs:signhere />

Search field

Adds a search field to the page content

<bs:tagsearch type="wikipage" namespace="QM" />

Subpages List of the subpages of a wiki page {{Subpages|parentpage=Mypage}}

Success Message

Message of type "success"

Adds colored panel for a success note

{{Textbox|boxtype=success|header=Example|text=Message text|icon=yes}}

Tag cloud Tag cloud based on categories or search queries <bs:tagcloud renderer="list" store="category" />

Task list

Task list output

Adds a checklist with tasks

[] Checkbox text

Task report

File:Content Droplets Task report.4 169997130662.png

Task report

Filterable list of existing tasks

Tip Message

Message of type "tip"

Adds colored panel for a tip

{{Textbox|boxtype=tip|header=Tip|text=sfsadf|icon=yes}}

User profile

User profile of type "Short"

A user profile will be included on this page

<bs:socialentityprofile username="WikiSysop" rendertype="Short" />

Video Embeds video from different external platforms (YouTube) <embedvideo service="youtube">JILEkPu61Ao</embedvideo>

Visited pages List with visited pages <bs:pagesvisited count="7" maxtitlelength="40" order="time" />

Warning Message

Message of type "warning"

Adds a colored box for a warning note

{{Textbox|boxtype=warning|header=Hello|text=|icon=yes}}

Watchlist Latest changes to pages included in your watch list <bs:watchlist count="5" maxtitlelength="20" order="time" />

More info

Technical Reference: ContentDroplets

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

@@ Line 35: / Line 35: @@
 |-
 | 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 in the book settings.
+| 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>
 |-
@@ Line 63: / Line 72: @@
 |-
 | 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>
 |-
@@ Line 82: / Line 91: @@
 |<code><nowiki><dataquery modified="+" format="ul" count="6" namespaces="Main" /></nowiki></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}}
+|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><decisionoverview namespaces=""></decisionoverview></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>
 |-
-| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | [[mediawikiwiki:Help:Images#Gallery_syntax|Gallery]] {{PopImg|file=droplet gallery.png|alt=Example of a gallery with three fish|caption=Gallery|width=}}
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[mediawikiwiki:Help:Images#Gallery_syntax|Gallery]]{{PopImg|file=droplet gallery.png|alt=Example of a gallery with three fish|caption=Gallery|width=}}
-| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Displays an image gallery
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | Displays an image gallery
 |<code><nowiki><gallery></nowiki></code>
@@ Line 129: / Line 146: @@
 |-
 | style="background-color:rgb(248, 249, 250);text-align:start;width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;color:rgb(32, 33, 34);font-family:Lato, &quot;sans-serif&quot;;font-size:13.9995px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;orphans:2;text-indent:0px;text-transform:none;white-space:normal;widows:2;word-spacing:0px;-webkit-text-stroke-width:0px;text-decoration-thickness:initial;text-decoration-style:initial;text-decoration-color:initial;" class="" |[[Templates download/Messagebox|Message]]{{PopImg|file=message.png|alt=Screenshot of a plain message|caption=A plain message}}
 | style="background-color:rgb(248, 249, 250);text-align:start;width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;color:rgb(32, 33, 34);font-family:Lato, &quot;sans-serif&quot;;font-size:13.9995px;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;orphans:2;text-indent:0px;text-transform:none;white-space:normal;widows:2;word-spacing:0px;-webkit-text-stroke-width:0px;text-decoration-thickness:initial;text-decoration-style:initial;text-decoration-color:initial;" class="" |Adds text panel
 |<code><nowiki>{{Textbox|boxtype=neutral|header=|text=SDadad|icon=no}}</nowiki></code>
 |-
 | style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Modal button|Modal button]]
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Configurable button which opens a customizable modal dialogue
 |<code><nowiki>{{ModalDialog|title=I am a dialog|btnLabel=click me!|body=This is the text|footer=hello world}}</nowiki></code>
 |-
 | style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList#Toplist|Most visited pages]]
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of the most visited wiki pages
 |<code><nowiki><bs:toplist count="3" period="-" /></nowiki></code>
 |-
 | style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList|New users]]
-| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of new users in the wiki
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | List of new users in the wiki
 |<code><nowiki><bs:newbies count="4" /></nowiki></code>
 |-
-| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/Messagebox|Note Message]]{{PopImg|file=message-note.png|alt=Screenshot of a note message|caption=Message of type "Note"}}
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/Messagebox|Note Message]] {{PopImg|file=message-note.png|alt=Screenshot of a note message|caption=Message of type "Note"}}
-| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Adds colored panel for a note
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | Adds colored panel for a note
 |<code><nowiki>{{Textbox|boxtype=note|header=|text=sfsadfasfdsdaf|icon=yes}}</nowiki></code>
 |-
@@ Line 161: / Line 178: @@
 |-
 | style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of users]]
-| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Shows the number of all users
+| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | Shows the number of all users
 |<code><nowiki><bs:countusers /></nowiki></code>
 |-
-| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | [[Reference:BlueSpiceWhoIsOnline|Number of users logged in]]
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:BlueSpiceWhoIsOnline|Number of users logged in]]
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Number of currently logged in users
 |<code><nowiki><bs:whoisonlinecount /></nowiki></code>
@@ Line 188: / Line 205: @@
 |<code><nowiki><bs:uenoexport>Don't export this text</bs:uenoexport></nowiki></code>
 |-
-| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | [[Manual:Extension/ContentDroplets#Progress|Progress]]
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Progress|Progress]]
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Visualizes progress against given measurement variables
 |<code><nowiki><bs:statistics:progress basecount="2" progressitem="OK" width="150" baseitem="Status:" /></nowiki></code>
@@ Line 196: / Line 213: @@
 |<code><nowiki>{{ProConList|title-advantages=Advantages|title-disadvantages=Disadvantages|advantages=* It is cheap|disadvantages=* It is sold out}}</nowiki></code>
 |-
-| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | [[Manual:Extension/BlueSpiceSmartList|Recent changes]]
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList|Recent changes]]
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of recently changed pages
 |<code><nowiki><recentchanges count="6" period="-" sort="time" showns="0" /></nowiki></code>
@@ Line 212: / Line 229: @@
 |<code><nowiki>{{Subpages|parentpage=Mypage}}</nowiki></code>
 |-
-| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/Messagebox|Success Message]]{{PopImg|file=message-success.png|alt=Screenshot of a success message|caption=Message of type "success"}}
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/Messagebox|Success Message]] {{PopImg|file=message-success.png|alt=Screenshot of a success message|caption=Message of type "success"}}
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Adds colored panel for a success note
 |<code><nowiki>{{Textbox|boxtype=success|header=Example|text=Message text|icon=yes}}</nowiki></code>
@@ Line 219: / Line 236: @@
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Tag cloud based on categories or search queries
 |<code><nowiki><bs:tagcloud renderer="list" store="category" /></nowiki></code>
+|-
+|Task list {{PopImg|file=droplet-task-item.png|alt=Checkbox with text example|caption=Task list output}}
+|Adds a checklist with tasks
+|<code>[] Checkbox text</code>
+|-
+|Task report {{PopImg|file=Content Droplets Task report.4 169997130662.png|alt=Filterable task report with 4 entries|caption=Task report}}
+|Filterable list of existing tasks
+|<code><taskreport user="" namespaces="" status=""></taskreport></code>
 |-
 | style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/Messagebox|Tip Message]]{{PopImg|file=message-tip.png|alt=Screenshot of a tip message|caption=Message of type "tip"}}
@@ Line 224: / Line 249: @@
 |<code><nowiki>{{Textbox|boxtype=tip|header=Tip|text=sfsadf|icon=yes}}</nowiki></code>
 |-
-| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceAvatars#Using the .3Cprofileimage.3E tag|User profile]] {{PopImg|file=userprofile.png|alt=Screenshot of the user profile|caption=User profile of type "Short"|width=300}}
+| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | [[Manual:Extension/BlueSpiceAvatars#Using the .3Cprofileimage.3E tag|User profile]] {{PopImg|file=userprofile.png|alt=Screenshot of the user profile|caption=User profile of type "Short"|width=300}}
 | style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |A user profile will be included on this page
-|<code><nowiki><bs:socialentityprofile username="WikiSysop" rendertype="Short" /></nowiki></code>
+| <code><nowiki><bs:socialentityprofile username="WikiSysop" rendertype="Short" /></nowiki></code>
 |-
 | style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/EmbedVideo|Video]]