Custom Icons
Custom icons must be stored as PNG images in the Icons folder within the /fcws/images folder of your FirstClass Web Services installation. Each icon is of the form XXXX.png where XXXX is the icon resource ID number.
How to retrieve icons from an existing Internet Services
Mac OS or Linux Shell Script to retrieve icons
You can use CURL or WGET and write a terminal or shell script to retrieve batches of icons from a server. CURL is already installed on OS X so I wrote a simple shell script that can be used to retrieve icons.
The you cn download the getIcons.sh script but in order to make it executable you must set the executable bit on the file.
Download the file and open a Terminal window in OS X and navigate to the folder where you have stored the getIcons.sh file
To make it executable, type chmod 755 getIcons.sh and press <enter>
Retrieving Icons Mac/Linux
Now to retrieve icons from a server, all you need to do is to run the shell script and answer the prompts.
To run the shell script, type bash getIcons.sh and press <enter>.
This will retrieve all icons from the specified server in the specified range.
Installing Curl on Windows
CURL is not native to the Windows OS so you have to install some files before you will be able to utilize the provided batch script to retrieve icons from a FirstClass server.
Unzip the Windows Curl Files.zip archive and copy the 4 files to your C:\WINDOWS\system32 directory
Retrieving the Icons on Windows
- Create a folder on your computer CustomIcons
- Copy the GetIcons.cmd file to that folder
- Double-click on that cmd file to launch the executable batch script and follow the prompts
The Icons will be retrieved to that folder.
Removing Invalid Icons
If there is no icon corresponding to the specified ID number requested, a generic icon will be downloaded. You will need to identify and remove these before copying the icons retrieved to your Icons directory
