Comus 変数
基本的にテンプレートは、Webページに配置する特別な {{macros}} によって制御されます。マクロは、Comus Thumbs に、物事を位置付けたいと伝えます。Comus はテンプレートページをスキャンし、リクエストとしてリンクと親指を差し込みます。また、ページ上の特別な操作を実行すると、選択した新しいページとディレクトリに結果が保存されます。 |
| 用語のマクロ、変数、拡張性、修飾子、リンク、親指。 |
| 用語集の簡単な概要 |
このセクションでは、スクリプトのビルディングブロックの紹介を行なうため、次の詳細情報のプライマーを提供します。 |
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 一日の最も頻繁なギャラリー
{{setquery-1-" の期間は DESC のクリックで 1 の順番で表示されます。
2 週最も人気のある
(リフレッシュ期間が毎日あると仮定し、それに応じて調整)
{{setquery-2-" の期間は < 8 と期間はショーン > 0 クリックして注文する DESC"}}
3 クリックで重量を重ねる
{{setquery-3-" 期間表示 >0 ORDER BY (clicks*rand())+(clicks*rand()))+(clicks*rand() DESC)}}
4 投票によって重くされる平均的なギャラリーの上
{{setquery-4-" 期間shown >0 をクリックし、 > sum(click)/count(*) 注文 (vote*rand())+(vote*rand()))+(vote*rand())))+(vote*rand()))}}
5 複数のカテゴリ選択
(最初に「all」のカテゴリタイプとして使用してから、スクリプトがフィルタリングされます。)
お問い合わせ
6 結合されたクエリ, 月優先投票からランダムなピックでランク付け, クリック秒
{{setquery-7-"(vote=1 OR (periodsshown < 30) ORDER BY 投票で、DESC をクリックします)}}
クエリ識別子の数字だけを使用して制限されていない方法は? [query-multicat] と同様に、クエリで上記の %global variables% を使うこともできます。
実際にこれらのクエリをリストに実装するには、マクロの最後に -query-query name}} を追加することでマクロを拡張します。
 |  | |
 |  |  |
 |  |  |
利用可能なクエリリストが表示されます特別なデバッグマクロがあり、カスタムクエリの構築を検討している場合は便利です。 既定のシステムクエリとして1つを定義していて、その代わりに、または perhps はカスタムクエリを作成するために使用します。 現在利用可能なすべてのアクティブなクエリのリストを表示するには、お問い合わせ. クエリを使用するには、'query identifier' として [key] を使うだけです。
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() "注意: これらは、利用可能なクエリの一部です。 ダンプして、追加または変更したかどうかを確認します。
マクロごとのスキムの貿易比率これは、マクロのmdiferによって行われます, あなたがスキーム比値であなたのカテゴリをプレフィックスする場所, 例えば {{#80#all-thumb-1}}
これにより、トレードスクリプトのプレフィックスとサフィックス定義(コントロールセンター内)内の%lshave%または%tshave%変数に80の値をフィードします。 lshave と tshave が数値でなければならず、トレードスクリプトの他の引数をフィードするテキスト文字列、または複数の引数、IE{{{#p=50&x=latin#all-thumb-1}} 取引スクリプトの変更のこのフォームは、次のカテゴリ定義によって取引比率よりも優先的にかかります。
カテゴリごとの取引比率%tshave% と %lshave% 変数を使用して、カテゴリ単位で取引スクリプトに取引比率をフィードすることができます。 カテゴリコントロールセンター内のスキーム比を確認できます。
取引スクリプトを1ページだけ分解する{{notrades}} マクロを使用して、ページ上のすべての取引を無効にすることもできます。 ページの上部にこのマクロを配置するので、ページ全体で有効になっていることを確認してください。 アーカイブページで、トレードスクリプトを完全に効果的に削除することができます。
セクションの取引スクリプトを無効にする比率を100に変えて、取引スクリプトを式から削除する方が良いでしょう。そうしないと、着信/外出のクリックを測定できず、統計や解析ソフトウェアを混乱させる可能性があるからです。
フォーマット:{{setlinktemplate-new link template}} | {{setthumbtemplate-new link template}} は setlinktemplate と setthumbtemplate がこのマクロをトリガーする特別なキーワードで、 new link template はリンクや thumb テンプレートに入れるもの
アクセサリーお問い合わせ
ノート: これは、現在のテンプレート上のすべてのリンクフォーマットを変更します。 セクション単位でリンクやテーブルの形式を変更するためにこれを使用することができますが、このマクロはテンプレート上のすべてのリンクに影響を及ぼすので、includeとテンプレートのビルドオプションを組み合わせる必要があります。 そのため、リンクスタイルを1つのセクションだけに置き換えたい場合は、セクションを異なるテンプレートに入れ、このマクロを新しいテンプレートで有効化し、メインページに戻り、結果を含む必要があります。
テンプレートでこれを使うと、そのテンプレートには setlinktemplate 修飾子もあれば、あなたのスタイルは含まれたテンプレートによって継承されません。
フォーマット:%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' (スペルに注意) の場合、 src フィールドは img src="%this weekday-0%day.gif" のように見えます。
ここには2つの変数があります。 Comusは、新しいギャラリーで1日1回、リクエストした時間に再構築します。 しかし、それはまた、クリック数などで変化を反映するために定期的にそれ自身をリフレッシュするために作ることができます, 毎回言う 10 分, これはリフレッシュ期間を介して制御されます.
自分のサイトに好きなだけ多くのファイルがあります。 デフォルトでは、スクリプトは、ファイルのいずれかが同じ画像を2回使用しているよりも確実に確認しようとします。ただし、これをオーバーライドして、カスタムページのために再び画像をプルすることができます。
通常、メインページファイルを最初にビルドし、サブページを構築し、最終的にアーカイブページを作成します。 注文は重要なことです。なぜなら、スクリプトは Make File がページを作ったり、ギャラリーから引き渡したりするからです。
makefile テンプレートの主なコマンドは、{makefile-sourcefile-targetfile}} マクロです。プロフィールこのマクロを呼び出すコマンドで、ソースファイルソーステンプレートとして使用するファイルの名前です。ターゲットファイルすべてのリンクと親指を含む結果のスクリプトまたはHTMLファイルの名前です。
無制限の数のテンプレートファイルがあり、無制限の数のターゲットファイルに書き込むことができます。 ディスクドライブのどこにでもかなり多く、許可を得ました。
各ターゲットファイルには、あらかじめコンパイルされた静的なページがあり、任意のファイル拡張子やタイプであってもよい。 より高速に読み込まれ、サーバー負荷が少なく、実行に高価なため、html のみターゲットファイルを作ることをお勧めします。
Comusのサイトをデザインするのは、他のウェブサイトと同じくらいで、実際にスクリプトを通じてサイトページをコンパイルするステップを1つ追加しました。 標準開発ツールを使用しても、すべてのマクロを含む /templates フォルダーにファイルをアップロードし、Comus が残りの部分をしたり、ファイルをサイトに投稿したりすることができます。