Last edited 2 months ago
by Hua Jing

2.2.7 Content droplets

VisualWikitext
No edit summary
Tags: Reverted 2017 source edit
m (Fixing link to Progress subpage)
Tag: 2017 source edit
 
(10 intermediate revisions by one other user not shown)
Line 2: Line 2:
{{BSVersion|bsvFrom=4.3.2|bsvFeature=ContentDroplets}}
{{BSVersion|bsvFrom=4.3.2|bsvFeature=ContentDroplets}}
{{TOClimit|limit=1}}
{{TOClimit|limit=1}}
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 ==
== Adding a droplet to a page ==
To add a droplet to a page:
To add a droplet to a page:
Line 15: Line 17:
{{Icon|bi bi-arrow-right-circle|||}} [[Manual:Extension/ContentDroplets/Examples|View examples of droplets outputs.]]
{{Icon|bi bi-arrow-right-circle|||}} [[Manual:Extension/ContentDroplets/Examples|View examples of droplets outputs.]]


<containerfilter selector=".wikitable tr"></containerfilter>
 
<containerfilter selector=".wikitable tr">
 
</containerfilter>
{| class="wikitable" style="width: 100%;"
{| class="wikitable" style="width: 100%;"
! style="background-color:rgb(234, 236, 240);text-align:center;width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);padding:8px;" class="" |'''Droplet'''
! style="background-color:rgb(234, 236, 240);text-align:center;box-sizing:border-box;border:1px solid rgb(162, 169, 177);padding:8px;" class="" |'''Droplet'''
! 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'''
! style="background-color:rgb(234, 236, 240);text-align:center;box-sizing:border-box;border:1px solid rgb(162, 169, 177);padding:8px;" class="" |'''Description'''
!Inserts the following in the page source:
!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="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
| style="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><attachments title="Attachments area"></nowiki></code>


Line 29: Line 34:
<code><nowiki></attachments></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="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.
| style="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>
|<code><nowiki><bs:booklist filter="Author:WikiSysop" /></nowiki></code>
|-
|-
Line 36: Line 41:
|PDF-download link to a book
|PDF-download link to a book
|<code><nowiki>{{BookPDFLink|book=Testbook|template=BlueSpice%20Book|label=Book PDF Link}}</nowiki></code>
|<code><nowiki>{{BookPDFLink|book=Testbook|template=BlueSpice%20Book|label=Book PDF Link}}</nowiki></code>
|}
|-
|Book table of contents{{PopImg|file=droplet-BookTOC.png|alt=First chapter of the book "Admin manual"|caption=Book table of contents|width=600}}{{Bsvs|bsvFrom=4.4}}
|Inserts the ToC of any book in a wiki page
|<code><nowiki><booknav book="Admin_manual" chapter="1" /></nowiki></code>
|-
| style="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="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="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="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="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[mediawikiwiki:Extension:CategoryTree|Categorytree]]
| style="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="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="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="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceChecklist|Checklist]]
| style="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="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="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="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Circled number
| style="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="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="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="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="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="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="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}}{{Bsvs|bsvTo=|bsvFrom=4.4}}
|Table with a list of decisions that were created by the ''Decision'' content droplet<br />
|<code><nowiki><decisionoverview namespaces=""></decisionoverview></nowiki></code>
|-
| style="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="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="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="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>
 
<code>File:test1.png</code>
 
<code>File:test.pdf</code>
 
<code><nowiki></gallery></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets/Icon|Icon]]{{PopImg|file=icon.png|alt=Example of a bootstrap icon|caption=Icons template}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Inserts an icon
|<code><nowiki>{{Icon|bi bi-arrow-left-circle}}</nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/Messagebox|Important Message]]{{PopImg|file=message-important.png|alt=Screenshot of important message|caption=Message of type "important"}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Adds colored panel for a important note
|<code><nowiki>{{Textbox|boxtype=important|header=OMG|text=Important|icon=yes}}</nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList|Links to this page]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of pages that link to this page
|<code><nowiki><whatlinkshere period="-" sort="time" showns="0" /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:BlueSpiceWhoIsOnline|List of users logged in]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Pop-up with a list of all users that are currently logged in
|<code><nowiki><bs:whoisonlinepopup /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/Maps|Map]]{{PopImg|file=map.png|alt=Screenshot of the map output|caption=Map output with text marker}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Locations can be marked on the map
|<code><nowiki>{{Map|Munich ~ Hello there!|Munich, Germany}}</nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[mediawikiwiki:Help:VisualEditor/User_guide#Editing_mathematical_formulae|Mathematical formula]]{{PopImg|file=math.png|alt=Math formula|caption=Screenshot of a math formula}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Display of mathematical formulas
|<code><nowiki><math>\tfrac{2}{4}</math></nowiki></code>
|-
| style="width:190px;" |Member list
|List of members of a wiki group
|<code><nowiki><bs:userlist groups="sysop" count="6" /></nowiki></code>
|-
| style="background-color:rgb(248, 249, 250);text-align:start;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;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="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Modal button|Modal button]]
| style="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="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList#Toplist|Most visited pages]]
| style="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="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList|New users]]
| style="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="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="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>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of characters]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Shows the number of characters or words in a wiki page
|<code><nowiki><bs:countcharacters /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of files]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Shows the number of all uploaded files
|<code><nowiki><bs:countfiles /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of  pages]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Shows the number of  pages
|<code><nowiki><bs:countarticles /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of users]]
| style="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="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:BlueSpiceWhoIsOnline|Number of users logged in]]
| style="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>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:BlueSpicePageAccess|Page access]]{{PopImg|file=pageaccess.png|alt=Screenshot of the page access notification banner|caption=Page access notification banner}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Restricts access to the page to the specified groups
|<code><nowiki><bs:pageaccess groups="sysop" /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |PDF link
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Link that downloads another wiki page as PDF
|<code><nowiki>{{PDFLink|page=Main Page|template=BlueSpice|label=PDF Link}}</nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |PDF page break
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Forces a page break at the set position during PDF export
|<code><nowiki><bs:uepagebreak /></nowiki></code>
|-
|[[Manual:Extension/ContentDroplets#PDF preview|PDF preview]]
|Embed preview of a PDF file
|<code><nowiki><pdf height="800">File:Raspberry_pi.pdf</pdf></code></nowiki>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceUniversalExport#Exclude content from PDF export|PDF no export]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Content within this section is excluded from the  PDF export
|<code><nowiki><bs:uenoexport>Don't export this text</bs:uenoexport></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets/Progress|Progress]]
| style="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>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Pros and cons|Pros and cons]]{{PopImg|file=pros and cons.png|alt=Screenshot of the pros and cons template|caption=Pros and cons}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Table for comparing pros and cons
|<code><nowiki>{{ProConList|title-advantages=Advantages|title-disadvantages=Disadvantages|advantages=* It is cheap|disadvantages=* It is sold out}}</nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList|Recent changes]]
| style="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>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSignHere|Signature]]{{PopImg|file=signatures.png|alt=Screenshot of the signatures button with a signature already added|caption=Signatures button}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |A button to add signatures in view mode
|<code><nowiki><bs:signhere /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceTagSearch|Search field]] {{PopImg|file=Suchfeld standard.png|alt=Screenshot of a search field with suggested results|caption=Search field|width=}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Adds a search field to the page content
|<code><nowiki><bs:tagsearch type="wikipage"  namespace="QM" /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:SubPageList|Subpages]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of the subpages of a wiki page
|<code><nowiki>{{Subpages|parentpage=Mypage}}</nowiki></code>
|-
| style="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="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>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceTagCloud|Tag cloud]]
| style="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 label|caption=Task list output}}{{Bsvs|bsvFrom=4.4}}
|Adds a checklist item
|[]


[] Checkbox text
[]  (2)
|-
|Task report {{PopImg|file=Content_Droplets_Task_report.png|alt=Filterable task report with 4 entries|caption=Task report}}{{Bsvs|bsvFrom=4.4}}
|Filterable list of existing tasks
|<code><nowiki><taskreport user="" namespaces="" status=""></taskreport></nowiki></code>
|-
| style="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"}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Adds colored panel for a tip
|<code><nowiki>{{Textbox|boxtype=tip|header=Tip|text=sfsadf|icon=yes}}</nowiki></code>
|-
| style="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="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>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/EmbedVideo|Video]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Embeds video from different external platforms (YouTube)
|<code><nowiki><embedvideo service="youtube">JILEkPu61Ao</embedvideo></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpicePagesVisited|Visited pages]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List with visited pages
|<code><nowiki><bs:pagesvisited count="7" maxtitlelength="40" order="time" /></nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Templates download/Messagebox|Warning Message]]{{PopImg|file=message-warning.png|alt=Screenshot of a warning message|caption=Message of type "warning"}}
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Adds a colored box for a warning note
|<code><nowiki>{{Textbox|boxtype=warning|header=Hello|text=|icon=yes}}</nowiki></code>
|-
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Watchlist|Watchlist]]
| style="box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Latest changes to pages included in your watch list
|<code><nowiki><bs:watchlist count="5" maxtitlelength="20" order="time" /></nowiki></code>
|}<br />


==More info==
==More info==
{{#subpages:Manual:Extension/ContentDroplets}}
{{#subpages:Manual:Extension/ContentDroplets}}
{{translation}}
{{translation}}

Latest revision as of 11:19, 6 September 2024

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:

  1. Click the Content droplets icon in the editor toolbar or type <<.
  2. Search for a droplet name in the search bar of the droplets menu or browse the droplets by category.
    droplet menu.png
  3. Select a droplet
  4. 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
Book table of contents

  v4.4+

Inserts the ToC of any book in a wiki page <booknav book="Admin_manual" chapter="1" />
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

  v4.4+

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">
Gallery
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 period="-" sort="time" showns="0" />
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
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
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

  v4.4+

Adds a checklist item []

[] Checkbox text [] (2)

Task report
Task report

  v4.4+

Filterable list of existing tasks <taskreport user="" namespaces="" status=""></taskreport>
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.

Retrieved from "https://en.wiki.bluespice.com/w/index.php?title=Manual:Extension/ContentDroplets&oldid=10027"