Last edited 4 months ago
by Monique Gähl

BlueSpice 4.3 and Manual:Extension/ContentDroplets: Difference between pages

(Difference between pages)
No edit summary
 
No edit summary
Tag: 2017 source edit
 
Line 1: Line 1:
{{Featurepage|featured=true|featuredesc=BlueSpice 4.2 has been released. Read about the notable changes now.|featurestart=07/28/2022}}
{{DISPLAYTITLE:Content Droplets}}
BlueSpice 4.3 is a minor release.   
{{BSVersion|bsvFrom=4.3.2|bsvFeature=ContentDroplets}}
{{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 toolbarThey also provide access to some templates that are preconfigured in the wiki, such as message boxes.


The code base was updated to '''MW 1.39'''. From this release on, '''PHP 8.2''' is supported.
== Adding a droplet to a page ==
To add a droplet to a page:


Release date:  
# '''Click''' the Content droplets icon in the editor toolbar or type <code><nowiki><<</nowiki></code>.
#'''Search''' for a droplet name in the search bar of the droplets menu or browse the droplets by category.[[File:droplet menu.png|none|thumb|550x550px]]
==Patch Releases==
#'''Select''' a droplet
#'''Click''' ''Insert''.
{{Messagebox|boxtype=note|icon=|Note text=Some droplets open an inspector menu which contains another ''Insert'' button. Be sure to confirm that button as well.|bgcolor=}}
Based on the type of droplet, you can continue with configuring the droplet as needed.


{{#ask: [[Release::4.3]]
==List of droplets==
|?Releasepatch = Release
{{Icon|bi bi-arrow-right-circle|||}} [[Manual:Extension/ContentDroplets/Examples|View examples of droplets outputs.]]
|?Releasedate#LOCL = Release date
|mainlabel= -
|headers = plain
|sort=Releasedate
|order=desc
|default=There have been no patch releases so far.
}}


==New Features==
{| class="wikitable" style="width:100%;"
!Feature
!Description
!Screenshot
|-
!Content Droplets
|<span style="color: rgb(89, 89, 90); font-family: Lato, &quot;sans-serif&quot;; font-size: 15px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;">We are introducing  ''Content droplets'' as a convenient way to insert special content in a wiki page. This includes tags, parser functions, and templates. This feature replaces the "Magic words"  menu item of the Visual Editor.</span>
*


<containerfilter selector=".wikitable tr">


{{Icon|bi bi-question-circle||#0d6efd|0.2em}} [[Manual:Extension/ContentDroplets|Documentation]]
</containerfilter>
|[[File:droplet menu.png|link=https://en.wiki.bluespice.com/wiki/File:droplet%20menu.png|alt=screenshot of the Content droplets menu|center|thumb|350x350px|Content droplets]]
{| 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;width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);padding:8px;" class="" |'''Description'''
!Inserts the following in the page source:
|-
|-
!Startpage Templates
| 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}}
|To support the creation of portal pages for the main page and for all other content namespaces, we now provide two startpage templates.
| 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>


To further support users with the design of portal pages, the renowned icon library Font Awesome is now bundled with BlueSpice.  
<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]]
| 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#Creating a checkbox|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>


{{Icon|bi bi-question-circle||#0d6efd|0.2em}}  [[Manual:Extension/MenuEditor|Startpage templates]]
<code><nowiki></syntaxhighlight></nowiki></code>
|<gallery widths="135" heights="135">
|-
File:Startpage Intranet.png|alt=Screenshot of "Startpage Intranet"|Startpage template 1
| style="width:190px;" |[[Manual:Extension/InputBox|Create page]]
File:Startpage Team.png|alt=Screenshot of "Startpage Team"|Startpage template 2
| style="width:380px;" |Form field for predefined page creation
</gallery>
|<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>
|-
|-
!Enhanced MenuEditor
|Decision  overview{{PopImg|file=ContentDroplets Decision report.png|alt=Decision report table|caption=Decision report output|width=600}}
|BlueSpice now includes useful page templates for numerous use cases. These can easily be modified or deactivated as needed.
|table with a list of decisions that were created by the ''Decision'' content droplet<br />
 
|<code><decisionoverview namespaces=""></decisionoverview></code>
 
{{Icon|bi bi-question-circle||#0d6efd|0.2em}} [[Manual:Extension/MenuEditor|Documentation]]
|
|-
|-
!PDF Embed
| 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}}
|It is now possible to embed a PDF viewer in wiki pages. It is contained in the Content Droplets menu for easy access.
| 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>
 
{{Icon|bi bi-question-circle||#0d6efd|0.2em}}  [[Reference:PDFEmbed|Documentation]]
|[[File:Extension PDFEmbed.png|alt=Screenshot of an embedded PDF file|center|thumb|350x350px|Extension PDFEmbed]]
|-
|-
!Container Filter
| 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=}}
|You can now mark sections of a page for filtering and display a filter just for the content located within these sections of the page.
| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" | Displays an image gallery
{{Icon|bi bi-question-circle||#0d6efd|0.2em}} [[Reference:ContainerFilter|Documentation]]
|<code><nowiki><gallery></nowiki></code>
|
|}


== Additional improvements ==
<code>File:test1.png</code>


* VisualEditor: the copy and paste functionality out of other applications (e.g., MS Word) has been significantly improved.
<code>File:test.pdf</code>


==Lists of added extensions==
<code><nowiki></gallery></nowiki></code>
{| class="wikitable" style="width:100%;"
|-
|+Developer: MW=MediaWiki extension; HW=Hallo Welt! extension
| style="width:190px;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}}
!Extension
| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Inserts an icon
!Description
|<code><nowiki>{{Icon|bi bi-arrow-left-circle}}</nowiki></code>
!Developer
|-
| style="width:190px;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="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList|Links to this page]]
| style="width:380px;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|count=5|sort=time|order=DESC}}</nowiki></code>
|-
| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:BlueSpiceWhoIsOnline|List of users logged in]]
| style="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[https://maps.extension.wiki/wiki/Displaying_Leaflet_maps Map]{{PopImg|file=map.png|alt=Screenshot of the map output|caption=Map output with text marker}}
| style="width:380px;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="width:190px;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="width:380px;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;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
|<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: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>
|-
| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of characters]]
| style="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of files]]
| style="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceCountThings|Number of  pages]]
| style="width:380px;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="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
|<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: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>
|-
| style="width:190px;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="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |PDF link
| style="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |PDF page break
| style="width:380px;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="width:190px;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="width:380px;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>
|-
|-
!ContainerFilter
| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Progress|Progress]]
|Allows to filter content elements within a page.
| 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
|HW
|<code><nowiki><bs:statistics:progress basecount="2" progressitem="OK" width="150" baseitem="Status:" /></nowiki></code>
|-
|-
!ContentStabilization
| style="width:190px;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}}
|<span style="color: rgb(32, 33, 34)">Replaces the approval mechanism previously provided by the extensions FlaggedRevs / BlueSpiceFlaggedRevsConnector. The experience for the user should be seamless.</span>  
| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Table for comparing pros and cons
|HW
|<code><nowiki>{{ProConList|title-advantages=Advantages|title-disadvantages=Disadvantages|advantages=* It is cheap|disadvantages=* It is sold out}}</nowiki></code>
|-
|-
!FontAwesome
| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpiceSmartList|Recent changes]]
|Allows highlighting of wikitext-syntax in the source view of a wiki page.
| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of recently changed pages
|MW
|<code><nowiki><recentchanges count="6" period="-" sort="time" showns="0" /></nowiki></code>
|-
|-
!InstanceStatus
| style="width:190px;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}}
|Allows to insert a header or footer (on a page basis or on a namespace basis) in the content area of ​​a page.
| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |A button to add signatures in view mode
|HW
|<code><nowiki><bs:signhere /></nowiki></code>
|-
|-
!PDFEmbed
| style="width:190px;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=}}
|Media handler extension for PDF files.
| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |Adds a search field to the page content
|MW
|<code><nowiki><bs:tagsearch type="wikipage"  namespace="QM" /></nowiki></code>
|-
|-
!PreToClip
| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Reference:SubPageList|Subpages]]
|Copies contents of PRE tags into the clipboard.
| style="width:380px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |List of the subpages of a wiki page
|MW
|<code><nowiki>{{Subpages|parentpage=Mypage}}</nowiki></code>
|-
|-
!SectionAnchors
| 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"}}
|Adds a link to headings for copying the path to the clipbard.
| 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
|HW
|<code><nowiki>{{Textbox|boxtype=success|header=Example|text=Message text|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/BlueSpiceTagCloud|Tag cloud]]
==Removed extensions==
| 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
*'''FlaggedRevs:''' Replaced with extension ContentStabilization.
|<code><nowiki><bs:tagcloud renderer="list" store="category" /></nowiki></code>
*'''BlueSpiceFlaggedRevsConnector''': Replaced with extension ContentStabilization.
|-
|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"}}
| style="width:380px;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="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>
|-
| style="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/EmbedVideo|Video]]
| style="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/BlueSpicePagesVisited|Visited pages]]
| style="width:380px;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="width:190px;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="width:380px;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="width:190px;box-sizing:border-box;border:1px solid rgb(162, 169, 177);break-inside:avoid;padding:8px;" |[[Manual:Extension/ContentDroplets#Watchlist|Watchlist]]
| style="width:380px;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==
{{#subpages:}}
{{translation}}

Revision as of 17:00, 29 November 2023

bsvFeature::ContentDroplets is available from BlueSpice bsvFrom::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   vbsvFrom::4.4+ PDF-download link to a book {{BookPDFLink|book=Testbook|template=BlueSpice%20Book|label=Book PDF Link}}
Book table of contents   vbsvFrom::4.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 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  vbsvFrom::4.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
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|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
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
Adds a checklist with tasks [] Checkbox text
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

"" has no sub pages.




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

No categories assignedEdit

Discussions