Intro
Web Port uses defined objects (functions and images) and naming convention to link tags with dynamic page objects. Each symbol library is placed in a subdirectory of the /assets/libs/ directory. An symbol library consists of a configuration file called lib.conf and a subdirectory called symbols where images for the symbol library are placed. If portlets exists, the sub-directory portlets is also used.
Information
There are two protected names may not be used to name a symbol library; "portlets" and "symbols"
Symbol Library
A symbol library consists of a set of images together with a description of their functions. The images can be of the raster type, for example .png and .gif, or of the vector type .svg. The images are placed under the directory symbols. The images are linked together by objects defined in the library's configuration file lib.conf. See chapter 5.6 for examples of how the symbol library is defined. If svg images are used, css and JavaScript can also be used to influence these. This is done by creating the style.css and script.js files. These files are automatically loaded when a page that uses the symbols is displayed and then then influences the symbols in the library.
There is an editor for symbol libraries, where you can create and edit symbol libraries. You can edit both portlets and symbols. The library editor can be found in the menu under System settings/Symbol Library.
In the library editor you can see all the symbol libraries in the system. By clicking a row in the table you get more information about the library in the sidemenu and the possibility to Edit, Download, and Delete library. It is also possible to go to edit mode directly by clicking the icon to the left on each row.
Download and upload symbol libraries
To be able to quickly make bulk changes to symbol libraries with many objects there is a possibility to download and upload entire libraries and handle them outside of Web Port.
Download a library as a zip file through the side menu of a library in the library editor’s view mode. Upload a zip file from the same view by clicking Upload in the toolbar menu. Reload from disk can be used if you have changed files directly in the file folders which need to be used in Web Port without restarting the system. This function is also in the toolbar menu above the list of symbol libraries.
Create symbol libraries
From the view mode of the library editor, click New library in the toolbar menu. Input a name and a decription in the sidemenu and click Save. This will take you directly into edit mode of the new symbol library. Click Back or the symbol library button in the toolbar menu to go back to view mode.
Note!
The name of the symbol library cannot contain underscore (_)
Edit symbol libraries
From the edit view of the library editor you can create new objects and edit existing ones. You can also edit lib.conf and style.css of the library.
Create new symbol
Click New object in the toolbar menu. Add a name and description and choose PageObject. Then click Save. The new object will be added and can be found in the object list. To choose an image for the symbol, click the symbol to get the sidemenu. Choose an image and click Save. To make the symbol interactive you can edit lib.conf to create different states for the symbol and style.css to describe how these states should look.
Create new portlet
Click New object in the toolbar menu. Add a name and description and choose Portlet. Then click Save. The new object will be added and can be found in the object list. For adding files to your portlet, click the symbol to get the sidemenu. Here you can edit the automatically created htm file and choose an icon for the portlet. It is also possible to handle other portlet files which your portlet is dependent on.
Remove portlet or symbol
Click on the object in the library editor in edit mode. Click Delete in the side menu and confirm.
Remove symbol libraries
To remove an entire symbol library, click the name of the library in the library editor in view mode, and click Delete in the sidemenu. Confirm to remove.
How-Tos
###SectionLinks 12346729744540 en-gb