Template:PopImg

Download

This template creates a set of images that is useful for linking to wiki pages.

Importing the template

The import file is included in the archive file HW-IamgeCards.zip. Unpack the zip file first.

On the page Special:Import follow these steps:

1. Select file and choose HW-ImageCards.xml.
2. Enter an Interwiki prefix. Since this field is required, simply add hw (for hallowelt).
3. Keep the selection Import to default locations.
4. Click Upload file...

The template is now available in your wiki.

Pages included in the import

The xml import creates the following files in your wiki:

• Template:Image_cards
• Template:Image_cards/start
• Template:Image_cards/end
• Template:Image_cards/styles.css

Adding image cards to a page

General considerations

• Start and end templates: Each card set needs the start template (Image cards/start) and the end template (Image cards/end). Make sure to add the end template right after the last image card without a line-break. If you have a line break, you will see some unnecessary space after the last card.
• Card sizes: You can choose between medium (standard), small and large image cards. By default, standard cards are shown.
• Images or icons: You can choose to create image cards or icon cards. Icon cards are only available in the sizes small and medium. If you want to uses images, you need to upload them to your wiki first.

See below for a complete list of available settings (template parameters).

Image cards

The easiest way to add card is to choose a starting layout from the examples provided on this page. Simply copy and paste the example code in source-editing mode into your page.

Important!Always paste any code using plaintext - Ctrl+Shift+v - in your wiki in source editing mode to avoid creating unnecessary tags which will break the view.

Standard-sized image cards

Standard-sized cards

Code to copy:

(Replace the file names for imgname= with the correct file names from your wiki )

{{Image cards/start|cardsize=}}
{{Image cards|imgname=yourimage1.jpg|label=London|imglink=https://google.de|alt=office in London headquarters}}
{{Image cards|imgname=yourimage2.jpg|label=Helsinki|imglink=http://google.de|alt=}}
{{Image cards|imgname=yourimage3.jpg|label=Madrid|imglink=Main Page|alt=}}
{{Image cards|imgname=yourimage4.jpg|label=Hamburg|imglink=Main Page|alt=}}
{{Image cards|imgname=yourimage5.jpg|label=Regensburg|imglink=|alt=}}{{Image cards/end}}

Large image cards

Large image cards

Code to copy:

(Replace the file names for imgname= with the correct file names from your wiki )

{{Image cards/start|cardsize=large|flexwrap=wrap}}
{{Image cards|imgname=yourimage1.jpg|label=Sales & Marketing|imglink=Main Page}}
{{Image cards|imgname=yourimage2.jpg|label=IT Admin|imglink=Main Page}}
{{Image cards|imgname=yourimage3.jpg|label=Development|imglink=Main Page}}
{{Image cards|imgname=yourimage4.jpg|label=Tech Support|imglink=Main Page}}
{{Image cards|imgname=yourimage5.jpg|label=Accounting|imglink=Main Page}}
{{Image cards|imgname=yourimage6.jpg|label=Management|imglink=Main Page}}{{Image cards/end}}

Bootstrap icon name

Icon cards

Supported icons:

• Bootstrap icons: Syntax is: bi bi-gear
• Font Awesome up to 6.2.1  v4.3+: fa-solid fa-house (v. 6) or fas fa-wrench (v.5)

Important!BlueSpice does not always include the latest version of bootstrap icons. See the list of currently supported icons.

Icon cards

Code to copy:

(Replace the file names for imgname= with the correct file names from your wiki )

{{Image cards/start|cardsize=}}
{{Image cards|iconname=bi bi-gear|iconcolor=Tomato|label=Processes|imglink=Main Page|alt=}}
{{Image cards|iconname=bi bi-lightbulb|label=How-to's|imglink=Main Page|alt=}}
{{Image cards|iconname=bi bi-eyeglasses|label=Knowledge base|imglink=https://google.de|alt=}}
{{Image cards|iconname=bi bi-signpost|label=Directories|imglink=Main Page|alt=}}
{{Image cards|iconname=bi bi-geo-alt|label=Locations|imglink=|alt=}}{{Image cards/end}}

Available settings

Template:Image_cards/start

Parameter	Value	Description
cardsize	medium (can stay empty, it is the default) small large	Sets the size of the individual cards
justifycontent	space-between (default)	Spreads the cards out evenly in the available space If the number of cards causes a line break and you don't want to switch from "space-between" to "flex-start", you can insert additional blank placeholder cards that "push" the cards in the second row to the left. You have to test the number of required placeholders. Here, 2 placeholders would be generated: {{Image cards|class=placeholder}} {{Image cards|class=placeholder}}
	flex-start	If there is a wrap to another line, the cards are left-aligned
flexwrap	nowrap (default)	Cards get smaller if many images are added to avoid wrapping
flexwrap	wrap	Cards keep their original size. Images that don't fit on the first row will move to the next row. This setting should be used with cardsize=large.

Template:Image_cards

Parameter	Value	Description
imgname	e.g.: myimage.jpg, myimage.png	Name of the image without a namespace prefix. It needs to be blank or not present if icons are used instead of images.
label	e.g.: London	Label that is shown under the image/icon.
imglink	e.g.: Main_Page Help:Main_Page https://google.com	Link to a wiki page or a website. The link is optional.
alt	e.g.: office in London headquarters	Provided for assistive technologies of users who cannot see the image. This is not necessary when using icons, since icons are loaded as background images only.
iconname	e.g.: bi bi-lightbulb	Used instead of imgname if icons are used as a visual.
iconcolor	e.g.: Tomato, #607d8b	HTML-color value. This includes color names or generally HEX-values.