User Tools

Site Tools


te3:toplist_tutorial2

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

te3:toplist_tutorial2 [2014/11/17 06:15] (current)
moderator created
Line 1: Line 1:
 +====== Create a description toplist ======
 +~~NOTOC~~
  
 +<WRAP caution>
 +We'll be using three fictitious trades (''<​nowiki>​http://​www.yourtrade1.com/</​nowiki>'',​ ''<​nowiki>​http://​www.yourtrade2.com/</​nowiki>''​ and ''<​nowiki>​http://​www.yourtrade1.com/</​nowiki>''​) for the purpose of this tutorial. If your database is empty at this stage, [[te3:​add_trade_single_tutorial|add three of your trades]]. If your database includes more than three trades, your results will differ from ours.
 +</​WRAP>​
 +
 +In addition to the ''​Site name'',​ you can also add a ''​Description''​ (even multiple) for each trade. The difference between the two is that “Description” is usually longer and more detailed. Both parameters can be displayed in the same toplist template simultaneously. ​
 +
 +Let's create a **text toplist with descriptions**:​
 +
 +----
 +
 +
 +===== 1. Add descriptions for your trades: ​ =====
 +
 +Navigate to the Toplist / Descriptions menu.
 +
 +You can manage all “Descriptions” for all your trades from this menu. Since there are no "​Existing"​ descriptions yet, let's add some - click {{:​te3:​add_button.png?​nolink|}} icon for ''​yourtrade1.com''​ and enter your description. ​
 +{{:​te3:​tut_toplist_desc2.png?​nolink|}}
 +Repeat the process with ''​yourtrade2.com''​ and ''​yourtrade3.com'',​ then {{:​te3:​button_save.png?​nolink|}} your entries.
 +{{:​te3:​tut_toplist_desc3.png?​nolink|}}
 +
 +----
 +
 +
 +===== 2. Create a toplist template =====
 +
 +TE3 toplist module can build toplists from your trades database, based on a template file and the first thing you need to do is to **build a toplist template** using TE3 template tags. 
 +
 +++++ List of TE3 template tags |
 +
 +|< 100% 15% 25% 60% >|
 +^ Parameter ^ Description ^ Example ^
 +| <color blue>##​desc:​x##</​color>​ | <color blue>​**Description**</​color>​ | <color blue>##​desc:​2##​ will print description for trade number 2. If multiple descriptions exist for the respective trade, they'​ll be randomly rotated each time toplist is generated.</​color>​ | 
 +| ''##​name:​x##''​ | **Site name** | ''##​name:​4##''​ will print "site name" for trade number ''​4''​. |
 +| ''##​domain:​x##''​ | **Domain name** (domain.com) | ''##​domain:​6##''​ will print "​domain name" for trade number ''​6''​. |
 +| ''##​raw:​x##''​ | **Incoming raws** | ''##​raw:​7##''​ will print "​incoming raws" for trade number ''​7''​. |
 +| ''##​uniq:​x##''​ | **Incoming uniques** | ''##​uniq:​3##''​ will print "​incoming uniques"​ for trade number ''​3''​. |
 +| ''##​clk_t:​x##''​ | **Clicks sent to trades** | ''##​clk_t:​4##''​ will print "​clicks sent to trades"​ for trade number ''​4''​. |
 +| ''##​clk_tg:​x##''​ | **Clicks sent to trades & galleries** | ''##​clk_tg:​2##''​ will print "​clicks sent to trades & galleries"​ for trade number ''​2''​. |
 +| ''##​out:​x##''​ | **Outgoing hits** | ''##​out:​5##''​ will print "​outgoing hits" for trade number ''​5''​. | 
 +| ''##​out_uniq:​x##''​ | **Outgoing uniques** | ''##​out_uniq:​6##''​ will print "​outgoing uniques"​ for trade number ''​6''​. |
 +| ''##​value:​x##''​ | **Value of a trade** (Clk T / Out T) | ''##​value:​2##''​ will print "value of a trade" for trade number ''​2''​. |
 +| ''##​owed:​x##''​ | **Owed** (Outgoing list / traffic distribution is based on the owed ratio) | ''##​owed:​13##''​ will print "​owed"​ for trade number ''​13''​. | 
 +| ''##​ratioraw:​x##''​ | **Ratio raw** (Out T / Raw) | ''##​ratioraw:​5##''​ will print "ratio raw" for trade number ''​5''​. |
 +| ''##​balanceraw:​x##''​ | **Balance raw** (outgoing total - incoming raws) | ''##​balanceraw:​3##''​ will print "​balance raw" for trade number ''​3''​. | 
 +| ''##​balanceratioraw:​x##''​ | **Balance ratio raw** (incoming raws / outgoing total) | ''##​balanceratioraw:​8##''​ will print "​balance ratio raw" for trade number ''​8''​. | 
 +| ''##​balanceuniq:​x##''​ | **Balance uniq** (outgoing total - incoming uniques) | ''##​balanceuniq:​3##''​ will print "​balance uniq" for trade number ''​3''​. |
 +| ''##​balanceratiouniq:​x##''​ | **Balance ratio uniq** (incoming uniques / outgoing total) | ''##​balanceratiouniq:​8##''​ will print "​balance ratio uniq" for trade number ''​8''​. |
 +| ''##​return_url:​x##''​ | **Return URL** (<​nowiki>​http://​www.example.com/</​nowiki>​) | ''##​return_url:​7##''​ will print "​return URL" for trade number ''​7''​. |
 +| ''##​nick:​x##''​ |** Webmaster'​s nickname** | ''##​nick:​2##''​ will print "​webmaster'​s nickname"​ for trade number ''​2''​. "​Nickname"​ is an optional attribute. If you would like to use this toplist tag, make sure you have it entered. |
 +| ''##​email:​x##''​ | **Webmaster'​s e-mail** | ''##​email:​8##''​ will print "​webmaster'​s e-mail"​ for trade number ''​8''​. "​E-mail"​ is an optional attribute. If you would like to use this toplist tag, make sure you have it entered. |
 +| ''##​icq:​x##''​ | **Webmaster'​s ICQ** | ''##​icq:​5##''​ will print "​webmaster'​s ICQ" for trade number ''​5''​. "​ICQ"​ is an optional attribute. If you would like to use this toplist tag, make sure you have it entered. |
 +
 +++++
 +
 +TE3 template tags allow you to create completely unique toplists, but for the purpose of this tutorial use the example template we've prepared below:  ​
 +
 +<​code>​
 +  <table border="​1"​ style="​width:​700px">​
 +
 +  <tr>
 +    <​th>​Domain</​th>​
 +    <​th>​Description</​th>​
 +    <​th>​Raw</​th>​
 +    <​th>​Value</​th>​
 +  </tr>
 +  <tr>
 +    <​td><​a href="/​te3/​out.php?​id=##​domain:​1##">##​name:​1##</​a></​td>​
 +    <​td>##​desc:​1##</​td>​
 +    <​td>##​raw:​1##</​td>​
 +    <​td>##​value:​1##</​td>​
 +  </tr>
 +  <tr>
 +    <​td><​a href="/​te3/​out.php?​id=##​domain:​2##">##​name:​2##</​a></​td>​
 +    <​td>##​desc:​2##</​td>​
 +    <​td>##​raw:​2##</​td>​
 +    <​td>##​value:​2##</​td>​
 +  </tr>
 +  <tr>
 +    <​td><​a href="/​te3/​out.php?​id=##​domain:​3##">##​name:​3##</​a></​td>​
 +    <​td>##​desc:​3##</​td>​
 +    <​td>##​raw:​3##</​td>​
 +    <​td>##​value:​3##</​td>​
 +  </tr>
 +  ​
 +  </​body>​
 +  </​code>​
 +
 +----
 +
 +
 +===== 3. Add new toplist =====
 +
 +Once you have created a toplist template, you have to **add it to yor TE3.**
 +
 +
 +==== Step by step ====
 +{{:​te3:​step_test8.png?​nolink|}}
 +
 +{{:​te3:​tut_step_1.png?​nolink|}} **Open "Add new" window** \\ 
 +Navigate to the ''​Toplist / Templates''​ menu, click on the {{:​te3:​interface_plus.png?​nolink|}}''​Add new''​ button and open "Add new" pop-up window.
 +
 +{{:​te3:​tut_step_2.png?​nolink|}} **Select input method** ​ \\ 
 +You can choose between two different [[te3:​toplist_input|input methods]], we'll test "Form input" method in this tutorial.
 +
 +{{:​te3:​tut_step_3.png?​nolink|}} **Add toplist template** \\ 
 +Now you have to add a toplist template into the textarea (if you use "File input" method, it is assumed, you have already uploaded your template at this stage). Copy-paste the example template we've prepared above. ​  
 +
 +{{:​te3:​tut_step_4.png?​nolink|}} **Save template as**  \\ 
 +Specify where would you like to save your template e.g., ''/​full/​path/​to/​public_html/​your_TE3_directory/​toplist/​something.tpl''​ \\ 
 +(this is a toplist file with template tags)
 +
 +{{:​te3:​tut_step_5.png?​nolink|}} **Output toplist as**  \\ 
 +Next, you have to enter File output path, e.g., ''/​full/​path/​to/​public_html/​your_TE3_directory/​toplist/​something.html''​ \\ 
 +(this is an output file - template tags get replaced with real values) ​
 +
 +{{:​te3:​tut_step_6.png?​nolink|}} **Save toplist** ​ \\ 
 +Click {{:​te3:​button_save.png?​nolink|}} button in the bottom right corner.
 +
 +
 +----
 +
 +
 +===== 4. Preview and edit the toplist =====
 +  ​
 +
 +
 +The new toplist is already added to the "​Existing"​ table. ​
 +{{:​te3:​tut_toplist5.png?​nolink|}}
 +  ​
 +Close "Add new" window and click {{:​te3:​button_preview2.png?​nolink|}} icon to see the ''​Preview''​ of what the toplist will look like. Ours looks like this:
 +
 +{{:​te3:​tut_toplist_output4.png?​nolink|}}
 +
 +Take a look at html source for our output - you can see that TE3 template tags were replaced with real values:
 +
 +{{:​te3:​tut_toplist_source6.png?​nolink|}}
 +
 +You can easily edit your toplist and test its output - click {{:​te3:​overview_edit_icon.png?​nolink|}} ''​Edit''​ icon for the respective toplist, then {{:​te3:​button_save.png?​nolink|}} your changes, and click {{:​te3:​button_preview2.png?​nolink|}} to ''​Preview''​ the toplist again. ​
 +
 +Note, If **multiple descriptions** exist for the respective trade, they'​ll be randomly rotated each time the toplist is generated, unless you want descriptions with specified positions.
 +
 +
 +
 +----
 +
 +===== 5. Include toplist into your web page =====
 +
 +After you have created and added a toplist, it has to be [[te3:​toplist_include|included]] into your web page!
 +
 +----
 +
 +
 +===== Related topics =====
 +
 +
 +  * [[te3:​toplist_index|Toplist templates]] - view toplist template syntax, learn how to add and manage toplists ​
 +
 +
 +  * [[te3:​toplist_descriptions|Toplist descriptions]] - learn how manage your descriptions
te3/toplist_tutorial2.txt · Last modified: 2014/11/17 06:15 by moderator