Manual DF™ TopList Pro/Lite
Help TopicsMain menu.
TopList Settings.
Editing List Pages (Mode 1).
Editing List Pages (Mode 2, ARP).
Traffic statistics.
Cheat statistics.
Member's account.
Search. Editing the search template.
Editing the Members Details Template.
Editing the "Contact Us" Template.
Editing The Gateway Page.
Black IP-list.
Black Lists of content.
HoldRank.
Database Backup/Restore.
Changing Administrative Password.
GeoIP database import
Voting
Format of date and time.
Editing List Pages (Mode 1)
Configuring design of a rating is carried out by editing html-templates of pages of a rating. Templates of pages have a set of macros which are filled by the necessary information at record of page on a disk of a server or at preliminary viewing. The Html-code of rating page is split into some parts: the top part of page (Header), repeating parts (Template) - templates of a line of the table of a rating, breaking parts (Breaks) - which are inserted between repeating parts, and a final bottom part of page (Footer).
The top part of page (Header) - a html-code with which a page begins, usually includes html-tags: <html>, <head>, </head>, <body>, <table>. The Header-part usually contains a html-code from the beginning of page up to the table of a rating, including the top of the table.
The repeating part (Template) - contains a html-code with the information on the member of a rating (a place, the title and the description of a site, a banner, statistics etc.). This part is inserted after a Header-part, filled for each account by his data and copied making the table of a rating. For any range of places it is possible to appoint the pattern of a repeating part. The repeating part can have some variants depending on a range of places. Inside a range of places it is also possible to use different repeating parts set by alternation. It is necessary, if you want to allocate every participant using other design, for example for setting various colors of cells' background of the table for even and odd sites. It is possible to set some sites in line using alternation of repeating parts. Using alternation sometimes it is necessary, that the number of repeating parts was divisible to amount columns in the created table of sites (for keeping of integrity of a HTML-code and closing tags), even if amount of displayed sites not divisible to it. For this purpose choose option "Complete this alternation" opposite to that alternating part which always should be last. At toplist generation missing sites will be filled with empty parts. If fillings it is not required, leave an option "Display only listed".
The breaking part (Breaks) - a html-code which is inserted between repeating parts after that place which will be specified in settings. The breaking part is inserted if there will be the number of sites that was specified in part. If the breaking part should be inserted irrespective of the necessary number of sites, "Always Show" configuring should be used.
Final part (Footer) - the bottom html-part of rating page. Usually contains html-tags: </table>, </body>, </html>.
Available macros in Header and Footer HTML:
[#RNKMODE#] - The mode of ranging toplist. Macro is replaced with the text "Reset every" in reset-mode and "Ranking rotation for" in no-reset mode. It is applied in pair with a macro [#RNKTIME#] or [#RNKTIMEH#].
[#RNKTIME#] - The exact time between resets in reset mode or the interval for which the statistics in no-reset mode is shown.
[#RNKTIMEH#] - Similarly to previous item. Time in hours, for want of it the fractional parts are discarded.
[#LAST_UPDT#] - Time of last rerank of a rating.
[#NEXT_UPDT#] - Time of the next rerank of a rating.
[#LAST_RSET#] - Time of last reset of a rating.
[#NEXT_RSET#] - Time of next reset of a rating.
[#TZNAME#] - The name of a time zone of toplist's time (GMT, MSK...).
[#GMTOFFSET#] - The difference in hours between toplist's time and Greenwich time (GMT.)
[#TOTAL_MBRS#]- Total of the registered members.
[#SUM_IN#] - Total quantity of IN-s on the end of the current page.
[#SUM_OUT#] - Total quantity of OUT-s on the end of the current page.
[#SUM_RAW#] - Total quantity of RAW-s on the end of the current page.
[#SUM_UNIQ#] - Total quantity of UNIQ-s on the end of the current page.
[#MAINOVRPAGE#] - The main (first) page of a rating.
[#NAMECATPAGE#] - The main (first) page of a rating in the current category.
[#MAINPAGE#] - The main (first) page of the category/main rating.
[#PREVPAGE#] - Previous page of the category/main rating.
[#NEXTPAGE#] - The next page of the category/main rating.
[#CGI_URL#] - The Web-address of a CGI-folder, is setting by the administrator.
[#CATSLCT#] - Macro used for a choice of categories in select html-tag.
[#SES#] - The unique session identifier. Also available in Template HTML.
Available macros in Template HTML:
[#ID#] - The identifier of toplist member.
[#ORNK#] - The rank of a site in the main rating.
[#CRNK#] - The rank of a site in a category.
[#RNK#] - Universal rank*.
[#SITE_URL#] - The URL of out link on the member's site.
[#TITLE#] - Title of the member's site.
[#DESCRIPTION#] - The description of the member's site.
[#DESCRIPTION_FULL#] - The description of the member's site without "Description Preview Length Limit".
[#BANNER#] - A html-code of a banner of the member's site.
[#BNR_URL#] - The URL of a banner.
[#BNR_WD#] - Width size of a banner.
[#BNR_HT#] - Height size of a banner.
[#FAKE_URL#] - The status bar browser when mouse is over the hyperlink.
[#RCP_URL#] - Recipe address (the return reference)
[#USR_FLD1#], [#USR_FLD2#], [#USR_FLD3#] - Value of the 1st, 2nd, 3d (and so on) defined field by the admin.
[#USR_FLD1_NAME#], [#USR_FLD2_NAME#], [#USR_FLD3_NAME#] - Name of the 1st, 2nd, 3d (and so on) defined field by the admin.
[#CATEGORY#] - The Category of a site of the member.
[#CAT_URL#] - The Address of top list's category.
[#ICON#] - The Icon of the member. It is defined by the admin
[#NICON#] - Icon New.
[#MICON#] - An Icon showing movement of a site in top list (up/down/unchanged).
[#HIDE_URL#] - The URL of hidden link, which is not available to usual visitors. Anticheat protection. Example of using: <a href="[#HIDE_URL#]"></a>
[#RAW#] - Amount of all incoming hits on toplist.
[#UNIQ#] - Amount of unique incoming hits.
[#IN#] - Amount of the counted incoming hits.
[#OUT#] - Amount of outgoing hits.
[#CLICK#] - Out Hits made by visitors of current member.
[#PROD#] - Current productivity of the member (Clicks/Raw*100%).
[#TRAW#] - Total all incoming hits on toplist.
[#TUNIQ#] - Total unique incoming hits on toplist.
[#TIN#] - Total the counted incoming hits on toplist.
[#TOUT#] - Total outgoing hits from toplist.
[#TCLICK#] - Total outgoing hits made by visitors of current member.
[#TPROD#] - Average productivity of the member (TClicks/TRaw*100%).
[#INPDAY#] - Average amount of the counted incoming hits in day (IN/Day).
[#INPWEK#] - Average amount of the counted incoming hits in a week (IN/Week).
[#INPMTH#] - Average amount of the counted incoming hits in a month (IN/Mon).
[#OUTPDAY#] - Average amount of outgoing hits in day (IN/Day).
[#OUTPWEK#] - Average amount of outgoing hits in a week (IN/Week).
[#OUTPMTH#] - Average amount of outgoing hits in a month (IN/Mon).
[#PORNK#] - The previous rank in the main toplist.
[#PCRNK#] - The previous rank in a category.
[#PRVIN#] - The previous value of the counted incoming hits.
[#PRVOUT#] - The previous value of outgoing hits.
[#SORTVAL#] - The value of statistics in which the sorting of members is occured.
[#PRVSORT#] - The previous value of statistics used to sort the members.
*Universal rank - rank in a page depending on type of page. When creating pages of the main toplist (overall) is rank in the main toplist, if categories is rank in a category.
The Random Site.
Each toplist's updating chooses one random site from all present in the list. Macros similar to ones with "RND_" are used to show it in the page :
[#RND_ID#], [#RND_SITE_URL#], [#RND_TITLE#], [#RND_DESCRIPTION#], [#RND_DESCRIPTION_FULL#],[#RND_BANNER#], [#RND_BNR_URL#], [#RND_BNR_WD#], [#RND_BNR_HT#], [#RND_FAKE_URL#], [#RND_RCP_URL#], [#RND_USR_FLD1#], [#RND_USR_FLD2#], [#RND_USR_FLD3#], [#RND_CATEGORY#], [#RND_CAT_URL#], [#RND_ICON#]
Configuring design of a rating is carried out by editing html-templates of pages of a rating. Templates of pages have a set of macros which are filled by the necessary information at record of page on a disk of a server or at preliminary viewing. The Html-code of rating page is split into some parts: the top part of page (Header), repeating parts (Template) - templates of a line of the table of a rating, breaking parts (Breaks) - which are inserted between repeating parts, and a final bottom part of page (Footer).
The top part of page (Header) - a html-code with which a page begins, usually includes html-tags: <html>, <head>, </head>, <body>, <table>. The Header-part usually contains a html-code from the beginning of page up to the table of a rating, including the top of the table.
The repeating part (Template) - contains a html-code with the information on the member of a rating (a place, the title and the description of a site, a banner, statistics etc.). This part is inserted after a Header-part, filled for each account by his data and copied making the table of a rating. For any range of places it is possible to appoint the pattern of a repeating part. The repeating part can have some variants depending on a range of places. Inside a range of places it is also possible to use different repeating parts set by alternation. It is necessary, if you want to allocate every participant using other design, for example for setting various colors of cells' background of the table for even and odd sites. It is possible to set some sites in line using alternation of repeating parts. Using alternation sometimes it is necessary, that the number of repeating parts was divisible to amount columns in the created table of sites (for keeping of integrity of a HTML-code and closing tags), even if amount of displayed sites not divisible to it. For this purpose choose option "Complete this alternation" opposite to that alternating part which always should be last. At toplist generation missing sites will be filled with empty parts. If fillings it is not required, leave an option "Display only listed".
The breaking part (Breaks) - a html-code which is inserted between repeating parts after that place which will be specified in settings. The breaking part is inserted if there will be the number of sites that was specified in part. If the breaking part should be inserted irrespective of the necessary number of sites, "Always Show" configuring should be used.
Final part (Footer) - the bottom html-part of rating page. Usually contains html-tags: </table>, </body>, </html>.
Available macros in Header and Footer HTML:
[#RNKMODE#] - The mode of ranging toplist. Macro is replaced with the text "Reset every" in reset-mode and "Ranking rotation for" in no-reset mode. It is applied in pair with a macro [#RNKTIME#] or [#RNKTIMEH#].
[#RNKTIME#] - The exact time between resets in reset mode or the interval for which the statistics in no-reset mode is shown.
[#RNKTIMEH#] - Similarly to previous item. Time in hours, for want of it the fractional parts are discarded.
[#LAST_UPDT#] - Time of last rerank of a rating.
[#NEXT_UPDT#] - Time of the next rerank of a rating.
[#LAST_RSET#] - Time of last reset of a rating.
[#NEXT_RSET#] - Time of next reset of a rating.
[#TZNAME#] - The name of a time zone of toplist's time (GMT, MSK...).
[#GMTOFFSET#] - The difference in hours between toplist's time and Greenwich time (GMT.)
[#TOTAL_MBRS#]- Total of the registered members.
[#SUM_IN#] - Total quantity of IN-s on the end of the current page.
[#SUM_OUT#] - Total quantity of OUT-s on the end of the current page.
[#SUM_RAW#] - Total quantity of RAW-s on the end of the current page.
[#SUM_UNIQ#] - Total quantity of UNIQ-s on the end of the current page.
[#MAINOVRPAGE#] - The main (first) page of a rating.
[#NAMECATPAGE#] - The main (first) page of a rating in the current category.
[#MAINPAGE#] - The main (first) page of the category/main rating.
[#PREVPAGE#] - Previous page of the category/main rating.
[#NEXTPAGE#] - The next page of the category/main rating.
[#CGI_URL#] - The Web-address of a CGI-folder, is setting by the administrator.
[#CATSLCT#] - Macro used for a choice of categories in select html-tag.
[#SES#] - The unique session identifier. Also available in Template HTML.
Available macros in Template HTML:
[#ID#] - The identifier of toplist member.
[#ORNK#] - The rank of a site in the main rating.
[#CRNK#] - The rank of a site in a category.
[#RNK#] - Universal rank*.
[#SITE_URL#] - The URL of out link on the member's site.
[#TITLE#] - Title of the member's site.
[#DESCRIPTION#] - The description of the member's site.
[#DESCRIPTION_FULL#] - The description of the member's site without "Description Preview Length Limit".
[#BANNER#] - A html-code of a banner of the member's site.
[#BNR_URL#] - The URL of a banner.
[#BNR_WD#] - Width size of a banner.
[#BNR_HT#] - Height size of a banner.
[#FAKE_URL#] - The status bar browser when mouse is over the hyperlink.
[#RCP_URL#] - Recipe address (the return reference)
[#USR_FLD1#], [#USR_FLD2#], [#USR_FLD3#] - Value of the 1st, 2nd, 3d (and so on) defined field by the admin.
[#USR_FLD1_NAME#], [#USR_FLD2_NAME#], [#USR_FLD3_NAME#] - Name of the 1st, 2nd, 3d (and so on) defined field by the admin.
[#CATEGORY#] - The Category of a site of the member.
[#CAT_URL#] - The Address of top list's category.
[#ICON#] - The Icon of the member. It is defined by the admin
[#NICON#] - Icon New.
[#MICON#] - An Icon showing movement of a site in top list (up/down/unchanged).
[#HIDE_URL#] - The URL of hidden link, which is not available to usual visitors. Anticheat protection. Example of using: <a href="[#HIDE_URL#]"></a>
[#RAW#] - Amount of all incoming hits on toplist.
[#UNIQ#] - Amount of unique incoming hits.
[#IN#] - Amount of the counted incoming hits.
[#OUT#] - Amount of outgoing hits.
[#CLICK#] - Out Hits made by visitors of current member.
[#PROD#] - Current productivity of the member (Clicks/Raw*100%).
[#TRAW#] - Total all incoming hits on toplist.
[#TUNIQ#] - Total unique incoming hits on toplist.
[#TIN#] - Total the counted incoming hits on toplist.
[#TOUT#] - Total outgoing hits from toplist.
[#TCLICK#] - Total outgoing hits made by visitors of current member.
[#TPROD#] - Average productivity of the member (TClicks/TRaw*100%).
[#INPDAY#] - Average amount of the counted incoming hits in day (IN/Day).
[#INPWEK#] - Average amount of the counted incoming hits in a week (IN/Week).
[#INPMTH#] - Average amount of the counted incoming hits in a month (IN/Mon).
[#OUTPDAY#] - Average amount of outgoing hits in day (IN/Day).
[#OUTPWEK#] - Average amount of outgoing hits in a week (IN/Week).
[#OUTPMTH#] - Average amount of outgoing hits in a month (IN/Mon).
[#PORNK#] - The previous rank in the main toplist.
[#PCRNK#] - The previous rank in a category.
[#PRVIN#] - The previous value of the counted incoming hits.
[#PRVOUT#] - The previous value of outgoing hits.
[#SORTVAL#] - The value of statistics in which the sorting of members is occured.
[#PRVSORT#] - The previous value of statistics used to sort the members.
*Universal rank - rank in a page depending on type of page. When creating pages of the main toplist (overall) is rank in the main toplist, if categories is rank in a category.
The Random Site.
Each toplist's updating chooses one random site from all present in the list. Macros similar to ones with "RND_" are used to show it in the page :
[#RND_ID#], [#RND_SITE_URL#], [#RND_TITLE#], [#RND_DESCRIPTION#], [#RND_DESCRIPTION_FULL#],[#RND_BANNER#], [#RND_BNR_URL#], [#RND_BNR_WD#], [#RND_BNR_HT#], [#RND_FAKE_URL#], [#RND_RCP_URL#], [#RND_USR_FLD1#], [#RND_USR_FLD2#], [#RND_USR_FLD3#], [#RND_CATEGORY#], [#RND_CAT_URL#], [#RND_ICON#]