Table of Contents
Introduction

With the icons function of ToplistX you can assign icons that will appear next to the accounts when they are displayed on the generated ranking pages. Icons can be assigned either to specific accounts or to partner accounts so that all accounts submitted by that partner will have the same icons displayed. This document will describe how to manage these icons.

Showing Icons on Your Ranking Pages

In order for the icons to appear next to your accounts on your ranking pages you will need to configure your template to show them. This involves using the {$account.icons} template value and looping over the assigned icons like so: {foreach from=$account.icons var=$icon} {$icon}   {/foreach} You can find more information about setting up your ranking pages in the Ranking Page Templates section of this manual.

Viewing/Searching Icons

To view or search your currently configured icons, access the Settings > Manage Icons function from the control panel menu. This will display a page where you will be able to see the currently configured icons and search them if you wish.

In the table that displays the icons, you will find a couple of functions that you can run on a single icon at a time. Each of those functions are described below. In addition to running these functions on single icons, you can also run the delete function on multiple icons at once. To run the delete function, put a check in the checkbox next to the icons you want to delete, then press the Delete button at the bottom of the page.

Adding an Icon

To add a new icon, access the Settings > Manage Icons function from the control panel menu. This will display your currently configured icons. Near the top of the page in the header bar that reads "Manage Icons" click on the icon. This will display a popup window where you will be able to enter the data for the new icon that you want to add. Each of the form fields are described below.
Note that the Icon HTML setting should be configured to the exact HTML code that you want to use for the icon. You can use any HTML code you like for your icons, which allows them to be plain text, contain image files, or be pretty much anything you want. If you want to use an image as an icon, for example, you would enter the complete HTML <img> tag in the Icon HTML field. The image file itself would need to already be uploaded to your server and the <img> tag would need to point to that image file.

Once you have filled in all of the fields as you want them, press the Add Icon button. This will add the new icon to the database, and it will be immediately available for assignment to specific accounts or partner accounts.

Editing an Icon

To edit an icon you will first need to locate it through the View/Search interface. When you locate the icon you want to edit, click on the image to bring up the icon editing interface. This interface is nearly identical to the icon addition interface, and has the same form fields with the same properties. You can make the changes that you want, and then press the Update Icon button to save your changes.

Deleting an Icon

To delete an icon you will first need to locate it through the View/Search interface. When you locate the icon you want to delete, click on the image, which will ask you to confirm the deletion.

You can also delete several icons at once by putting a check in the box next to the icons you want to delete, then pressing the Delete button at the bottom of the page.