User Tools

Site Tools


rand_items_widget

Differences

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

Link to this comparison view

Next revision
Previous revision
rand_items_widget [2014/03/18 17:05]
127.0.0.1 external edit
rand_items_widget [2018/06/13 17:52] (current)
admin [Random Members]
Line 1: Line 1:
-====== Random Items Widget ​Update ​======+====== Random Items Widget ​Mod ======
  
-This update ​allows the member and photo widgets to display random items (members/​photos). If you think that the Latest Members widget is too static for your site, you can use this update ​to make your site appear more dynamic.+This mod allows the member and photo widgets to also display random items (members/​photos). If you think that the Latest Members widget is too static for your site, you can use this mod to make your site appear more dynamic.
  
 ===== Installation ===== ===== Installation =====
  
 Installation is pretty straight-forward:​ Installation is pretty straight-forward:​
-  - Copy the .zip file you receive after purchase ​to tmp/​packages on your server +  - [[https://​drive.google.com/​folderview?​id=0B5GPLc5dytbhUHltaG12cHEzMDA&​usp=sharing#​list|Go to the Etano Downloads Repository]] 
-  - Go to your admin panel Package Manager and click on the install link +  - Download the **rand_items_widget-1.04.zip** file and upload it to **tmp/​packages** on your server, **DO NOT UNZIP**, the Package Manager will handle this 
 +  - Go to your admin panel and select the **Package Manager** from the menu and click on the install link
 ===== Usage ===== ===== Usage =====
  
Line 14: Line 14:
  
 ==== Random Members ==== ==== Random Members ====
 +To a make widget display random members on the main index page, use this code inside skins_site/​def/​index.html file:
  
-To make the widget display random members add this code inside any html file from the skins_site/<some skin>/ folder:+<code><!--widget="​members(array('​mode'​=>'​rand','​area'​=>'​front'​))"​--><​/code>
  
-  <​!--widget="​members(array('mode'=>'​rand'​))"​-->​+You can also set the number of items to display buy including the 'total' ​code at the end like this:
  
-This update can also display random members with a certain profile property, which is a very powerful feature. For example you can display random women or random men but also random members with red hair or random members seeking men. +<​code>​<​!--widget="​members(array('​mode'​=>'​rand','​area'​=>'​front','​total'=>5))"​--><​/code>
-The usage in this case is like this: +
-  ​<​!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'​<​some_dbfield>​','​cmp_to'=>'<​some_value>'​))"​-->​ +
-or, the most complex: +
-  ​<!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'<​some_dbfield>','​cmp_to'​=>'<​some_value>','​cmp'​=>'<​sql comparison operator>'​))"​-->+
  
-The meanings of the 3 new fields are: +**Note** the default maximum number of items allowed is 15. If you want to display more than 15 you will need to open the plugins/​widget/​members/​members.class.php file and locate ​the following code and change ​the LIMIT number.  
-  ​* **cmp_field**: the field from the user_profiles database table to use for comparisonYou can find the name of the fields either by directly looking at the table in the database with a db management tool like phpmyadmin or in your admin panel - Profile Fields - the code in paranthesis (e.(f1I am a - in this case the field name is __f1__). + 
-  * **cmp_to**: the value to compare cmp_field with. In case cmp_field is a select box (combo box) the value you want to compare to is a number. All values a field can take are stored as numbersFor example, if the field "(f1) I am a" has the values "​Male" ​and "​Female" ​in this order, then "​Male"​ is stored as '1' ​in the database ​and "​Female"​ as '​2'​So if you want to show random male members your cmp_to value must be '​1'​. +<code>$query.=" LIMIT 15"; if (!($res=@mysql_query($query))) {trigger_error(mysql_error(),​E_USER_ERROR);​} $user_ids=array();</​code>​ 
-The same applies ​to multiple checkboxes fields but instead of comparing ​to '​1',​ you need to compare to '​|1|'​. Same for females: your cmp_to field must be '​|2|'​+ 
-  * **cmp**: this field specifies ​the actual comparison to be performed. Default is '=' meaning that it will show only members whose cmp_field is equal to cmp_to value. You can use any of the following comparison operators  +**TIP** - be careful how many items you display on your page, having too many can cause slower page performanceYour index page is the main page that Google lists and ranks in their search engine and Google typically ​ prefers pages that aren't slow loading or too bloated. It's best to try and keep your index page focused and to the point making sure visitors can quickly grasp what your site is about and what it has to offerWidgets should ​be considered teasers and provide just enough ​to make visitors want to explore further and ultimately signup ​to see more
-    * '=' ​- equals + 
-    * '>' ​- greater than +To make the widget display random members on the member's home page or other pages use this code inside ​the appropriate html file from the skins_site/​def/​ folder
-    * '>=' - greater or equal than + 
-    * '<' ​smaller than +  <​!--widget="​members(array('mode'=>'rand'))"--> 
-    * '<​='​ - smaller or equal than + 
-    * '​like'​ - the LIKE operator from SQL syntaxIn this case you can use SQL wildcards in the cmp_to value. Note: the use of the '​like'​ operator is not recommended because it could slow down your site.+This mod update can also display random members with a certain profile property, which is a very powerful featureFor example ​you can display random women or random men.
  
-Some examples for the default Etano package: 
   * Random male members:   * Random male members:
 <​code><​!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'​f1','​cmp_to'​=>'​1'​))"​--></​code>​ <​code><​!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'​f1','​cmp_to'​=>'​1'​))"​--></​code>​
   * Random female members:   * Random female members:
 <​code><​!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'​f1','​cmp_to'​=>'​2'​))"​--></​code>​ <​code><​!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'​f1','​cmp_to'​=>'​2'​))"​--></​code>​
-  ​Random ​members from US:+ 
 +  ​**cmp_field**:​ the field from the user_profiles database table to use for comparison. You can find the name of the fields either by directly looking at the table in the database with a db management tool like phpmyadmin or in your admin panel - Profile Fields - the code in paranthesis (e.g (f1) I am a - in this case the field name is __f1__). 
 +  * **cmp_to**: the value to compare cmp_field with. In case cmp_field is a select box (combo box) the value you want to compare to is a number. All values a field can take are stored as numbers. For example, if the field "(f1) I am a" has the values "​Male"​ and "​Female"​ in this order, then "​Male"​ is stored as '​1'​ in the database and "​Female"​ as '​2'​. So if you want to show random male members your cmp_to value must be '​1',​ and to show female members your cmp_to value must be '​2'​. If you've added more (f1) values such as "​Couples"​ or "​Transgenders",​ their cmp_to value numbers will be in the order you have them listed in the admin (f1) profile fields. 
 + 
 +You could also display random ​members from a certain country like this: 
 <​code><​!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'​f4_country','​cmp_to'​=>'​218'​))"​--></​code>​ <​code><​!--widget="​members(array('​mode'​=>'​rand','​cmp_field'​=>'​f4_country','​cmp_to'​=>'​218'​))"​--></​code>​
  
-You can [[http://​www.datemill.com/​contact.php|contact us]] if you need more help with this.+**218** in the above example is the ID number for the country, which in this case is for the US.\\
  
 +If you want the ID for a different country you will need to look in the database. Click the **dsb_loc_countries** table, then from the country the list find the country you want and make note of the number next to it under the **country_id** column.
 ==== Random Photos ==== ==== Random Photos ====
  
-To make the widget display random photos add this code inside ​any html file from the skins_site/<some skin>/ folder:+To make widget display random photos add this code inside ​the index.html file: 
 + 
 +<​code><​!--widget="​photos(array('​mode'​=>'​new','​area'​=>'​front','​total'​=>​6))"​--></​code>​ 
 + 
 + 
 +To make a widget display random photos on the member'​s home page or other pages use this code inside the appropriate ​html file from the skins_site/def/ folder: 
 + 
 +<​code><​!--widget="​photos(array('​mode'​=>'​rand'​))"​--></​code>​ 
 + 
 + 
 + 
 +==== Important Info Regarding Adding The Random Widget ==== 
 + 
 +Refer to your **skins_site/​def/​index.html** file, you'll see sections like the following ... 
 +<​code><​!-- Newest Members widget -->  
 +<div class="​front-widget">​  
 +<​h3>​Newest Members</​h3>​ 
 +<​!--widget="​members(array('​mode'​=>'​new','​area'​=>'​front','​total'​=>​12))"​-->​  
 +</​div><​!-- End Newest Members widget --></​code>​ 
 + 
 +Add your random items widget as follows ... 
 +<​code><​!-- Random widget --> 
 +<div class="​front-widget">​ 
 +<​h3>​Featured Members</​h3>​ 
 +<​!--widget="​members(array('​mode'​=>'​rand','​area'​=>'​front','​total'​=>​12))"​-->​ 
 +</​div><​!-- End Random widget --></​code>​
  
-  <!--widget="photos(array('​mode'​=>'​rand'​))"-->+If you want you can you can replace the "​Newest Members ​widget" ​with a "Random widget"​. You can also add widget codes in any order you want. The order you add them in the file is the order in which they will be displayed on the page.
  
rand_items_widget.1395162337.txt.gz · Last modified: 2014/03/19 12:45 (external edit)