计数变量
基本上,模板由您在网页上放置的 QQmacros 控制,宏告诉 Comus 缩略图要放置在什么地方, Comus 然后扫描模板页面, 并按您的要求插入链接和拇指, 或者在页面上执行特殊操作, 将结果保存为您所选择的新页面和目录 。 |
| 术语:Macros,变相,Extensions,Modifers,Links,Thumbs. |
| 术语快速概览 |
本节介绍剧本的构件,为下文更详细的资料提供入门. |
FORMAT: {{category-type-index}}
Where category is either 'all' or the case sensitive name of a chosen category, and type is one of [link or archivelink] and index is the selector of which link in thelist to use.
EXAMPLE: The 1st, 3rd and 2nd link in the list, taken from only the teen category.
| Lesbians - Young Lesbian Closeup | Babes - Busty Aria Giovanni | Teens - Cute Brunette Poser | Lesbians - Young Lesbian Closeup |
NOTES: You would use this type, if you wanted very specific control over your layout, maybe you want to place banners and blind links in the middle of your table, this is a perfect use for Singular links.
-Singular links do not need table tags, unless you define the link template in such a way to require them.
-If singular links do not find any images in a particular category, or do not have enough images to complete the list, then they will search at random throughout your gallery listings, to make up the difference.
-By default images have priority over links, but once used as an image or a link the gallery will be flagged and will not be available to the other lists.
-Note in this example I deliberately doubled up on the 1st teen link, the script automatically places the first occurance of the link in both locations.
-Indexes start at 1 and run sequentially upwards, if you miss an index (1,2, ,4,5) then the script will drop your last images, in this case it would see there were only 4 links requested, and it would have no image avail for index 5.
FORMAT: {{category-type-index}}
Where category is either 'all' or the case sensitive name of a chosen category, and type is one of [thumb or archivethumb] and index is the selector of which link in the list to use.
EXAMPLE: A custom table of 3 by 3 thumbs, taken from the teen database
 |
 |
 |
 |
 |
 |
 |
 |
 |
-The lower the number the higher the priority of that image in your list. So index=1 is the very first thumb pulled from your list, depending on how you have ordered your list, this could be a high priority image. By default, images are sorted at random but weighted by the rank you assign to them through the approval process. Each prefered submitter can have his own default rank that you can assign, and each standard submitted gets a default vote of 7. This gives you 3 levels of downgrade and 6 levels of upgrade to play with. Each level represents approximately a 10% jump, so votes of 1 should consistently fall somewhere within the top 10%, as the votes fall more towards the extremities they become less eratic, while votes in the mid ranges will tend to bounce around a lot. This is done so votes you upgrade, will tend to get sent to the top of the list, and votes you down grade will tend to randomize at the bottom, while votes in the middle will get a fair jumbling.
-archivethumb types are explained below, but basically pull from the list after all links and thumbs have been processed.
FORMAT: {{category-type-index}} Where category is either 'all' or the case sensitive name of a chosen category, and type is one of [link or archivelink] and index is the selector of which link in the list to use.
EXAMPLE: A custom table of 3 by 3 links
| Fetishbizarre - Slut Gets Spanked | Amateurs - Amateur Panties | Teens - Tawnee Vids/pics |
| Babes - Babe In Stocks | Anal - Anal Please | Fetishbizarre - Hard Bondage |
| Teens - Beautiful Erotic Brunette | Interracial - Sluts W Huge Cock | Lesbians - First Lesbian Experience |
FORMAT: {{include-(path or url)sourcefile}} Where include is the keyword to trigger this macro, and sourcefile is the name of the file to include.
ALIAS: This command is an Alias for {{showfile-sourcefile}}
EXAMPLE: A default include file has been set up for this demo. It contains a single thumb and a short messge. The file itself is created in the next section, note that because of the forward reference that any changes to the file will not be reflected until the next refresh of the page.
This is an included document test_out.txt
-Included files do NOT get interpreted by the template processor, they just get added to the current output, to process macros on a page file, see below.
-By default files are extracted from the /templates folder, but you can use ../ path modifications to reach the rest of your drive, or you can just use a direct http:// url, but note where you use the url it will interpret your page first.
-Includes allow you to use special sections like 'headers' and 'footers' which are built into your pages at compile time, allowing you the benefit of shtml/php/asp includes without having to have a runtime script while in production. That means you can run the TGP side of your site entirely in HTML only mode, reducing server overhead and costs considerably.
-Includes can also be used to load your archives or the results of custom template builds. (see next section for info on custom templates)
FORMAT: {{makefile-(path or url)sourcefile-targetfile}}
Where 'template' is the keyword to trigger this macro, and sourcefile is the name of the file to load and process and targetfile is the name of the file to save results to.
EXAMPLE: Building a custom template
When this macro is placed on a page, it will first check to see if a rebuild is required, if it is then it will load the desired template from your /templates directory by default, or it will search the path, or load from the http:// URL you have specified.
-The source file can also execute the same macros as your makefile template. It can build and include pages and write them to disk (into the templates folder by default). You can also specifiy other locations by adding relative path information to the filename. IE. {{makefile-testin.txt-../../testout.txt}} would take the file testin.txt, parse it and write the results 2 folders up from the ct/templates folder. (Assuming Comus is in the subfolder /ct/ then it would write the file into the main index folder of your site.
-You might need to make sure that PHP has permissions to read/write the files. New target files will usually complain about permission errors, you will need to chmod 777 the target file, so that both you and Apache have read/write/execute to the target file.
-Templates can be used to create Archive pages. The script will start pulling thumbs from the top most 'makefile' macro found within Templates Control Center and then execute the 'makefile' macros found within each source template. The lowest macro on the page, gets the eldest thumbs. Remember this if you are trying to lay pages out and are wondering why your new thumbs are not showing up.
-Once you have created a page, to reference or link to the page you can either { include } it using the method mentioned above, or you can include it using a php or an SSI include. Or if you have designed your template so that the page can stand completely alone, you can name it with a .html extension and reference it directly.
-The macro works on both templates and the Make Files Section found inthe Templates control center.
-Note that no links or code are created ON the page that actually invokes this macro. If you need to link to the resulting page, or if you need to view the results, then you will either have to create a link to the page, or you will need to use an include to load the results into a page. So for example, you could use an include to load the template result onto your main page.
-If you use this feature it is best to try and build the template, before you try to include it.
-A resulting template page can only be manipulated by the first macro which calls it, subsequent requests to write to the same file during the same session, will be ignored.
-Your target filenames can have any extension they like, and so your templates can be in any scripting language you like.
-You have the option of loading the template file with any language you like, Comus's include method should be the fastest during run time, because it compiles the code right into the page so that it can be static. But you can load the page dynamically at load time if you like with PHP/ASP/SSI/JS or whatever.
NOTES: Archive galleries are the galleries that remain after all the current galleries have been extracted.
-By placing multiple makefile macros in the makefile template it gives you the option of creating separate pages which contain archived links and thumbs.
The method we use for accessing the archive galleries is to simply control the order in which we request the pages from within the master Makefile template.
[START MAKEFILE]
{{makefile-indexpage.txt-../../index.shtml}}
{{makefile-archivepage.txt-../../archive.shtml}}
[END MAKEFILE]
Will process your indexpage.txt file FIRST and write it to index.shtml in your web root folder, pulling the most current galleries. It will then use what remains in your pool to create the archives.
NOTE:You need to make sure you use macros within the archive pages which only look for thumbs which are 1 day or older say with an query-age1}} extension, or your archive page will probably try to pull fresh galleries, as all basic non extended macros will always try to grab fresh thumbs by default.
For example.
The system has a default query for pulling galleries of one day older or more.
{{all-links-20-1-query-age1}}
Will list a vertical column of 20 links, which are 1 day or older.
-The idea is that you create a separate template page to your main page for holding your archived galleries, and then on this archive page you place your {{category-type-dimension}} macros.
-Then you either place a direct link to the resulting file, from your main page, or you can include the resulting page, by using a macro/shtml/php/or the scripting language of your choice. Note because of the nature of the macro ordering, when using {{include}} for displaying archived gallery pages you will have to display the archives from the previous build, or in other words, the archive listings will be 1 build old, when displayed. (hope it makes sense as to why)
| Local Variables-Only avail within link and thumb templates | |
| Variable | description |
| %onpage% | The number of times the gallery has been displayed on a page, or actually used in a build, this ONLY increases when the gallery is actually used. |
| %clickperiods% | The number of times galleries have been built since this gallery was listed as new, note that this increments regardless of whether the gallery was actually used on a page. |
| %periodsshown% | The number of DAYs passed since the gallery was newly used on the site. |
| %clicks% | The number of clicks on the gallery. |
| %ctr% | The Click Through Ratio for this gallery, a score defined as clicks/clickperiods. |
| %cat% | The condensed category taken from the database as entered in the [Category] section. |
| %category% | The category taken from the macro - IE shows 'all' for all. |
| %rawcategory% | The category taken from the database without condensing (no removed spaces). |
| %url% | The target url. |
| %overurl% | The target url, used for mouse overs (without trade script). |
| %domain% | The domain only of the target URL |
| %desc% | The truncated description, (max length set by you) |
| %description% | The full description |
| %uid% | The unique id assigned to the gallery |
| %id% | The true id for the gallery |
| %nick% | Submitters name |
| %thumbname% | The actual file name to the thumb |
| %thumbheight% | The thumb image width |
| %thumbwidth% | The thumb image height |
| %thumbsize% | For compatibility, width of square thumbs |
| %numpic% | Number of pics in the gallery (always 2 chars, ie 00...08,09,10,11) |
| %piccnt% | A running count of the total links and thumbs displayed |
| %numlist% | A running count of the links and thumbs in this set only |
| %thumbsize% | For compatibility, width of square thumbs |
| %vote% | The ranking score (1-10) assigned to the gallery |
| %rank% | The ranking score assigned by you |
| %clicks% | The number of times the gallery has been clicked |
| %dis_date% | Custom formatted date of submittal |
| %TODAYS_DATE% | Non formatted day of the month, with no leading 0's |
| %submit_date% | Custom formatted date of submittal |
| %submit_hour% | 00-24 hour of submittal |
| %submit_day% | 01-31 day of submittal |
| %submit_month% | 01-12 month of submittal |
| %submit_year% | xxxx year of submittal |
| %accept_date% | formatted date of approval |
| %accept_hour% | 00-24 hour of approval |
| %accept_day% | 01-31 day of approval |
| %accept_month% | 01-12 month of approval |
| %accept_year% | xxxx year of approval |
| %listed% | formatted date of first listing |
| %listed_date% | formatted date of first listing |
| %listed_hour% | 00-24 hour of listing |
| %listed_day% | 01-31 day of listing |
| %listed_month% | 01-12 month of listing |
| %listed_year% | xxxx year of listing |
| Global Variables-Available Anywhere | |
| Variable | description |
| %this_date% | formatted date of today |
| %this_HOUR% | 00-24 hour of today |
| %this_hour% | 00-12 hour of today |
| %this_day% | 01-31 day of today |
| %this_month% | 01-12 month of today |
| %this_YEAR% | xxxx year of today |
| %this_year% | xx year of today |
| %sitename% | The domain name of your site without http:// |
| %siteowner% | The name you chose for yourself in setup |
| %tgpemail% | your registered email address |
| %recip% | Your recip link with http:// info |
| %refreshperiod% | The current refresh period |
| %this_period% | The current refresh period |
| %totalposts% | Total number of posts made |
| %logins% | Total number of webmaster logins |
| %hits% | Total hits on the page |
| %total_galleries% | Total approved galleries in the system |
| %updates% | Number of days passed since the site was new, the actual age of your site. |
| Local Variables-Only avail within link and thumb templates | |
| Variable | description |
| %lshave% | Text Link Shave value, will be replaced by either the 'lshave' value from Category Control Center or the #80# modifier value from within the macro, the macros have priority over category settings, there is one other thing that can affect lshave and that is the proxy capping settings. |
| %tshave% | Just like lshave only it is intended to affect the thumbed listings |
| %group% | Taken from the {{GROUP#SHAVE#category-type-index}} GROUP modifier can be used to send trades to your trade groups. |
| %category% | Feeds a compressed category tracking code to your trade script, you canuse this to track link popularity. |
| %proxy% | Feeds a code to the script of 'p' for a proxy click or a 'n' for a normal click. You can use this to track outgoing proxy traffic to identify hitbots. |
This would allow you to dynamically control shave ratios based on macro position, or category, it would also pass link tracking information through to the script, which would look like, p_TXT_Teen for a click on a teens text link from someone on a proxy server. (FYI Abnormal outgoing Proxy server traffic is an indication of someone using a hitbot on you, and can be used to monitor cheaters, if your ratio.)
FORMAT: {{category-type-index-query-"string"}} | {{category-types-rows-columns-query-qindex}} where query is a keyword to trigger this macro extension and qindex is an index to preset query (See below)
{{all-thumbs-3-3-query-"description like '%blonde%' or url like '%blonde%'"}} EXAMPLE {{setquery-1-"description like '%blonde%' or url like '%blonde%'"}} {{all-thumbs-3-3-query-1}}
This would first define a query and give an id of 1, the second macro then uses the defined query to search descriptions and urls for anything containing blonde. Note that the query is a mySQL WHERE clause and must be within double quotes ""
NOTES: Advanced capability, highly flexible and powerful. Finally, as I started thinking about all the options that I could build lists with, I decided to just expose the database query string and structure to you. So whatever your imagination can think of, is available to you. You will need to know how to structure a mySQL WHERE clause - so go look up queries on mysql.org.
Basically it gives you the ability to build custom lists and filters using less than, greater than, equal to, similar to, starts with, ends with,etc,etc and order them in any way you please. (If the script does not detect an ORDER BY, then it will assign its default ordering algorithm of date desc,rand()*vote.)
NOTE: It is not a full query, but just a WHERE clause.
You can use the 'query' capability of the post/review/search page to test the results of your queries, before you actually use them.
See the next section for an advanced application and examples of this option.
| Available fields | |
| Field | Description |
| id | Unique ID code |
| ip | IP of submitter |
| nickname | Name the submitter gave |
| Email address the submitter gave | |
| url | URL of gallery |
| category | Gallery Category |
| description | the full string of what the user gave the gallery |
| date | The date it was subitted in YYYYMMDDHH format |
| newpost | Yes if not yet approved |
| accept | Waiting/Yes/No |
| vote | 1=good ... 10=poor |
| recip | 'Yes'=has recip |
| sessionid | A unique 6 char string |
| numpic | Number of pics linked to images found in the gallery |
| filesize | Byte size of html page |
| thumbname | If blank then a link else if has a name then we have a thumb |
| mailme | Wants contact if approved |
| listed | The time that the gallery was listed in YYYYMMDDHH format |
| mgdate | The time that you approved the gallery in YYYYMMDDHH format |
| thumbwidth | The pixel width of the thumb |
| thumbheight | The pixel height of the thumb |
| clicks | The total number of times the link was clicked |
| timespent | The estimated time people have spent looking at the gallery in secs |
| exitclicks | The number of people who never return from the gallery |
| periodsshown | The number of times you have listed this gallery |
NOTES:This uses a combination of features built into Comus, and works with the custom 'Query' capabilities of the script.
To invoke counting set 'click counting' to Yes in the config setup page, this will modify all outgoing links on the page to re-route via cc.php and then on to your trade script.
The script will keep a running count of clicks and impressions and time spent at every gallery, now you can start using it in custom queries to build lists.
1个日间最频繁的画廊
==================================== ==========================================================================================================================================================================================================================
2 最受欢迎的一周
(假设刷新期为每日,否则相应调整)
=============================================================================================================================================================================
3 随机但按键加权
XQSetquery-3-" 周期shown >0 ODER BY (点击 *rand ())+ (点击 *rand ())+ (点击 *rand ()) DESC"
4 高于经投票加权的平均画廊
=====================================================================================================================================================================================
5 多个类别选择
(确保您首先将其作为“ 所有” 类使用) 然后脚本会过滤您 。
“% setquery- multicat-”(类如“% 9% ” 或类如“% 业余% ” )
6 综合查询,以月优先票数的随机抽取数排名最高,点击第二
(投票数=1 OR (周期数 < 30))
注意您如何不仅限于对查询标识符只使用数字 ? 如 [query- multicat] , 也可以在查询中使用上面定义的% global 可变% 。
现在要在您的列表中实际执行其中的查询之一, 您会通过在您的宏 IE 结尾添加 -query- query name 来扩展宏 :
 |  | |
 |  |  |
 |  |  |
有一个特殊的调试宏, 将显示可用的查询列表, 如果您考虑构建一个自定义查询, 这可能很方便 。 我们可能已经定义了一个默认的系统查询, 你可以使用它, 或者用它来构建一个自定义查询 。 要显示您可以使用的所有当前活动查询列表,{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢?。只使用 [键] 作为您的“ query 识别符 ”
query[age0]=" periodsshown >-1 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) )"query[age1]= "periodsshown > 0 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) )"query[age2]= "periodsshown > 1 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age3]= "periodsshown > 2 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age4]= "periodsshown > 3 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age5]= "periodsshown > 4 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age6]= "periodsshown > 5 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age7]= "periodsshown > 6 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age14]= "periodsshown> 13 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age21]= "periodsshown > 20 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[age28]= "periodsshown > 28 ORDER BY periodsshown, ( (vote*rand())+ (vote*rand()) + (vote*rand()) ) "query[days most clicked]=" periodsshown=1 order by clicks DESC, mgdate DESC"query[this weeks most clicked]= "periodsshown < 8 AND periodsshown >0 order by clicks DESC, mgdate DESC"query[last weeks most clicked]= "periodsshown < 15 AND periodsshown >7 order by clicks DESC, mgdate DESC "query[random by click]= "periodsshown>0 ORDER BY (clicks*rand())+(clicks*rand())+(clicks*rand()) DESC "query[above average]= " clicks > sum(clicks)/count(*) ORDER BY vote*rand()"query[last weeks best]= " ((vote= 1AND periodsshown >7 AND periodsshown < 15 ) ORDER BY clicks DESC "query[weeks best]= " ((vote< 4 AND periodsshown < 7) ORDER BY clicks DESC,vote*rand() "query[months best]= " ((vote< 4 AND periodsshown < 30) ORDER BY clicks DESC,vote*rand() "注:这些只是一些现有的查询,做一个垃圾堆,看看我是否添加或修改了这些查询。
Skim/每个宏的贸易比率这是通过一个宏摩迪弗来完成的,在这里,您要用滑动比值前缀您的分类, 如 ####80#all-thumb-1}}##
这将在您的交易脚本前缀和后缀定义( 在控制中心内找到) 中将 80 的值反馈到% ls 有 % 或% ts 有% 的变量 。 请注意, ashave 和tshave 不一定是一个数字, 它们也可以是文本字符串, 用于为您的交易脚本提供其他参数, 甚至是多个参数, IE{{#p=50&x=latin#all- thumb-1}} 这种形式的贸易脚本修改比下一个取消的类别定义的贸易比率更为优先。
每类贸易比率通过使用 %tshave% 和%lshave% 变量,可以将交易比率输入到您的交易脚本中。 您可以在分类控制中心找到这些小幅比例。
只禁用一页的交易脚本您也可以使用 QQnotrades 宏来禁用页面上的每个交易 。 将此宏放在页面顶端附近, 这样您就可以确定该宏是否为整个页面激活 。 它可以在存档页面上被用来有效去除交易脚本完全.
禁用一节的贸易脚本将你的比例修改为100比从等式中删除你的交易脚本要好,因为否则它将无法测量出/入/出点击量,并可能破坏你的统计和分析软件。
福马特:\\ setlinktemplate- new link template \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
实例========================================= =====================================================================================================================================================================================================================
说明: 这改变了当前模板上的所有链接格式。 您可以用它来逐节修改链接或表格格式, 但你需要合并包含和模板构建选项, 因为这个宏会影响模板上的所有链接 。 因此,如果您想要只替换一节的链接样式,那么您就必须将章节放入不同的模板,在新模板上激活这个宏,然后返回您的主页并包含结果.
如果您在模板上使用此选项, 然后包含另一个模板, 您的样式将不会被包含的模板所继承, 除非该模板在模板上也有一个设置链接模板修改器 。
福马特:% this weekday-index% 其中指数为0到6的值,代表0到6天前.
实例如果今天是周一在服务器上
% this weekday-0%=蒙语
% this weekday-1%=太阳
说明: 这创造了一个3个字母代码,代表了一周的一天,3个字母代码是案件敏感. 蒙克,图克,韦德,图克,弗利,萨特,孙 您可以使用它来创建一组图像文件, 代表您工作日的头条 。 IE:如果您有一套名为 “ 周一. gif、 Tueday. gif、 Wedday. gif、 Friday. gif、 Satday. gif、 Sunday. gif ” (注意拼写) 的头条, 那么您的 img src 字段会看起来像 img src ="% this weekday-0%.gif ) 。
注意这里有两个变量。 科默斯会每天用新画廊重建一次, 在您要求的时间。 但也可以定期刷新自己,以反映点击数的变化等,比如每10分钟一次,通过刷新期控制.
您可以在您的网站中随意保存文件 。 默认情况下, 脚本将尝试确保所有文件都两次使用相同的图像, 尽管您可以覆盖它, 并再次为自定义的页面拉出图像 。
通常要先构建主页文件,再构建子页,再最终构建存档页. 秩序很重要,因为脚本会运行到 Make File 构建的页面中,然后从你的画廊中抽取它。
makefile 模板的主要命令是 QQMakefile- sourcefile- targetfile- macro, 其中创建文件引用此宏和源文件是用作源模板的文件的名称,并且目标文件是生成的脚本或 HTML 文件的名称,其中将包含您的所有链接和缩略语。
可以拥有无限数量的模板文件,也可以写入无限数量的"目标文件". 磁盘驱动器上的任何地方都差不多 只要你有权限
每个目标文件都是被预编译的静态页面,可以属于任何文件扩展或类型. 我们建议只制作html"目标文件",因为它们加载速度快,服务器加载量少,运行成本更低.
为科穆斯设计一个网站与任何其他网站几乎相同,加上一个步骤,即通过脚本实际汇编网站页面. 您仍然可以使用您的标准开发工具, 简单地将您的文件上传到包含您全部宏的 /templates 文件夹中, 然后让 Comus 来完成其余的工作, 构建您的文件并将其发布到您的网站 。