MODUL: Zufallsprodukte auf beliebigen Seiten (random products)

[Jossi]

Moin!

Timo-Tell Oswald hat da mal ein sehr geniales Modul gebastelt. Es ermöglicht für jede Kategorie und jede Produktseite oder auch die Startseite unterschiedliche Artikel aus einer oder mehreren Kategorien als Zufallsprodukte in beliebiger Menge anzeigen zu lassen.

Da scheinbar einige Schwierigkeiten mit der Installation und Einstellung dieses Moduls haben/hatten (nicht zuletzt ich) möchte ich versuchen das noch einmal möglichst einfach und genau zu beschreiben.

Vorweg: Dieses Modul hat keine eigene Bedienoberfläche, man nimmt Einstellungen vor, indem man die

                                   new_products.html
                                   new_products_default.html
                                   product_listing_v1.html
                                   product_info_v1.html
                                   categorie_listing.html
                                   usw.

bearbeitet. Dazu ist jeweils nur ein kurzer, einzeiliger Code nötig.

Das Modul ist im Grunde mit nur 3 Schritten installiert:

Vorbereitung:

       - Wie immer Shop sichern/Backup ... oder erst einmal lokal auf einem Testshop ausprobieren.
       - Modul runterladen
       - Zip entpacken.

Installation:

       1. Die Datei "function.tt_random.php" (aus dem Ordner "Smarty_Plugins") in den Ordner
       "includes/classes/Smarty_2.6.26/plugins/" kopieren.

       2. Den Ordner "tt_random" mit enthaltener tt_random_default.html (aus den Odnern
       "templates/tt_default") in den Ordner
       "templates/DEIN_TEMPLATE/module/" kopieren.

       3. Die Datei "tt_random_language.conf" (aus dem Ordner "lang")  in den Ordner
       "lang" kopieren.

 fertig!

(Die "Smarty.class.php" habe ich nicht benötigt.)

Das Modul erscheint NICHT im Backend unter Module, es muss/kann nicht aktiviert werden.

Um es zu nutzen muss man nun den Code {tt_random max=X cat=Y} in eine der oben genannten Dateien kopieren - einfach ans Ende setzen.

max= Anzahl der zu erscheinenden Artikel - für X eine beliebige Zahl einfügen.
cat= Kategorie-Nr aus der/denen die Artikel ausgewählt werden sollen. (Die Kategorie-Nummer ist die letzte Ziffer, die im Browser einer Kategorie angezeigt wird. Also das Y mit der gewünschten Kategorie-Nr ersetzen.)

Die optische Anpassung kann man in der Datei "tt_random_default.html" (templates/DEIN_TEMPLATE/module/tt_random/) vornehmen.

Beispiel 1:

Um Zufallsprodukte zu einem Artikel anzeigen zu lassen, kann man den Code nun einfach in ans Ende einer der product_info Dateien setzen. Es empfielt sich gegebenenfalls mehrere neue Dateien zu erstellen, zB: product_info_v2.
Den Code am Ende einfügen, zB:  {tt_random max=10 cat=50,62}
Es sollen also auf der Produktseite 10 weitere Artikel aus den Kategorien 50 und 62 angezeigt werden.
Achtung: Nicht vergessen, die neue "product_info_v2" im Backend bei Kategorien/Artikel (in der jeweiligen Produktmaske des Artikels unter "Vorlage für Artikeldetails") auszuwählen!

Auf diese Weise hat man eine sehr gute und meiner Meinung nach praktischere Alternative zum Cross Selling.

Beispiel 2:

Um zufällige Produkte auf einer Kategorie-Seite mit mehreren Unterkategorien anzeigen zu lassen, können wir den Code einfach in der "categorie_listing.html" ans Ende setzen. Auch hier empfielt es sich gegebenenfalls eine neue Datei zu erstellen, zB: categorie_listing_V2.html

Diese muss dann auch wieder in der Eingabemaske der jeweiligen Kategorie im Backend unter "Vorlage für Kategorieübersicht" ausgewählt werden.

Das selbe kann man natürlich auch auf der Startseite als Ersatz für die "New Products" machen ...

Sollte "das Modul" oder besser die zufällig ausgewählten Artikel nicht angezeigt werden, so könnte es eventuell am Cache liegen, das hat mich zB. lange aufgehalten.

Ich hoffe dass diese Beschreibung hilft manchen No-Profs und Laien dieses wirklich gelungene Modul problemlos zu installieren und zu nutzen.

An dieser Stelle auch ein großes Lob und herzlichen Dank an den Entwickler Timo-Tell Oswald!
 

                                                                                                                                        Jossi

Linkback: https://www.modified-shop.org/forum/index.php?topic=29755.0

[ulobo]

ji jossi,

vielen Dank für Deine ausführliche und exakte Anleitung.
Habe die Shopversion 1.6.0 rev4642 im Einsatz und alles hat lt. Deiner Einbauhilfe hingehauen. Mit der dem Modul beiliegenden PDF-Anleitung hätte ich es wohl nicht hinbekommen. Habe übrigens die "Smarty.class.php" ebenfalls nicht gebraucht.

Nochmals danke,
ulobo

[ulobo]

... habe noch was vergessen:
anfangs wurde bei mir kein Produkttext angezeigt.

In der tt_random_default.html steht in Zeile 46: {$module_data.PRODUCTS_DESCRIPTION}.
Wenn man dies ersetzt mit {$module_data.PRODUCTS_SHORT_DESCRIPTION},
dann klappt's auch mit dem Nachbarn.

have fun,
ulobo

[Wave]

Nutze auch die neuste Shop Version. Bei mir Funktioniert das Modul nicht. Cache hab ich geleert. Die Schritte nochmal durchgegangen. ( Wird nichts angezeigt. )

[Gradler]

Wo wird nichts angezeigt? Mit dem alleinigen Einbau ist es ja noch nicht abgetan.

[Jossi]

Hallo Wave,

Um es zu nutzen muss man den Code {tt_random max=X cat=Y} in eine der folgenden Dateien kopieren - einfach ans Ende setzen:

  new_products.html
  new_products_default.html
  product_listing_v1.html
  product_info_v1.html
  categorie_listing.html

max= Anzahl der zu erscheinenden Artikel - für X eine beliebige Zahl einfügen.
cat= Kategorie-Nr aus der/denen die Artikel ausgewählt werden sollen. (Die Kategorie-Nummer ist die letzte Ziffer, die im Browser einer Kategorie angezeigt wird. Also das Y mit der gewünschten Kategorie-Nr ersetzen.) Für X musst du eine beliebige Zahl und für Y die jeweilige(n) Kategorienummer(n) ersetzen.

Die optische Anpassung kann man in der Datei "tt_random_default.html" (templates/DEIN_TEMPLATE/module/tt_random/) vornehmen.

Und du darfst nicht vergessen, die geänderte Datei auch in der jeweiligen Kategorie- oder Produktseite im Backend auszuwählen.

Hast du das alles auch gemacht?

[Wave]

Ich hab das ganze hier eingebaut: categorie_listing.html

dann Cache geleert und geschaut. Keine Funktion.

Für die categorie_listing.html ( Original ) gibt es doch Backend keine Einstellung oder doch ?

[Jossi]

Wenn die Produkte auf einer Kategorieseite angezeigt werden sollen, dann ist die categorie_listing.html schon richtig.
Jetzt check mal, ob die im Backend bei der jeweiligen Kategorie auch ausgewählt ist:

Backend - Kategorien/Artikel - Kategorie ... bearbeiten!
Dann bei "Vorlage für Kategorieübersicht:" muss die geänderte Datei ausgewählt sein.

Wenn das nicht klappt, versuch einfach mal, die Datei umzubenennen und neu auszuwählen. Möglicherweise läd das System die (geänderte) Datei nicht neu, weil der Name derselbe ist. Auch bei geänderten Fotos mit gleichem Namen dauert es sonst manchmal etwas länger, bis das System die Änderung übernimmt. Das sollte zwar eigentlich durch das Leeren des Cache behoben werden, kommt bei mir aber trotz Cache-leeren immer wieder vor.

[Wave]

Tut sich leider nichts. Schade eigentlich.

[Jossi]

Hallo Community,

kann mir vielleicht irgendjemand Tipps geben, wie man dieses Modul unter der neuen Shopversion V2.0.0.0-r9678 (mit responsivem Modified Template) zum Laufen bringt, bzw. wo man welche Anpassungen vornehmen muss?

Oder gibt es ein vergleichbares, neueres Modul das in oben genannter Shopversion funktioniert?

Hoffe sehr, mir kann jemand weiter helfen, dieses Modul fand ich ziemlich genial und einfach zu handhaben.

Jossi

[newbee79]

Moin zusammen!

Muß mich auch nochmal kurz in das tt_random Thema einklinken…

Gibt es die Möglichkeit, auch Artikel aus der products_new.php anzeigen zu lassen?
Da gibt es ja keine Kategorie-Id, die ich angeben könnte.

Vielen Dank im Voraus schon für eine Antwort.

P.S. noch ein kleiner Tipp, was ich jetzt erst bemerkt habe:
Man kann auch verschiedene Template-Vorlagen für das Modul nutzen!
Einfach das gewünschte Template in der Abfrage ansteuern z.B. {tt_random max=4 cat=143 tpl=pure}.
Das Template muß dann in dem tt_random Ordner unter Module liegen und heißt dann anstatts hinten "_default.html" dann eben "_pure.html".

Ich finde das ganz praktisch, wenn ich z.B. Artikel auf der Startseite prominenter promoten will ( ohne Preis, größer o.ä. )

Vielleicht ist der kleine Tipp ja jemandem nützlich. 

LG David

[Jürgen]

Hallo zusammen,

eingebaut und funktioniert soweit...

Leider funktioniert die Abfrage des Plugins mit folgendem Aufruf (also mit deaktiviertem cache, wie in der Anleitung beschrieben)

Code: XML  [Auswählen]

{dynamic}{tt_random}{/dynamic}

 bei mir nicht....weisse Seite...

Jemand eine Idee?

Gruß

Jürgen

[Jürgen]

Gerade gesehen.....

da gab es mal einen zusätzlichen Post zu dem Modul in welchem ein User das gleiche Problem mit dem cache hatte...

https://www.modified-shop.org/forum/index.php?topic=6265.msg108129#msg108129

Problem blieb leider ungelöst....?

Aufgrund der Anleitung bin ich davon ausgegangen, dass das umschliessen der Variable mit

{dynamic} XXX {/dynamic}

ausreicht.....

Auf der smarty.net steht dazu noch ein bischen mehr mit Beispiel.... was ich jedoch inhaltlich nicht verstehe  ....

https://www.smarty.net/docsv2/de/caching.cacheable

Warscheinlich muss da an der zugehörigen php Datei auch was gemacht werden damit das dynamic greift ????

Finde aber leider keinen passenden Codeschnipsel wie in dem Beispiel auf smarty.net, meine Versuche enden alle mit einer weissen Seite....

Code: PHP  [Auswählen]

<?php
/*  TTO
  ------------------------------------------------------------------------------
  $Id: function.tt_random.php, v0.1 13.03.2008 11:00:00 TTO $
 
  Random Products für XT:Commerce 3.04 SP2.1 und andere  

  Copyright (c) 2008 Timo-Tell Oswald
                www.ctm21.de | tt.oswald@ctm21.de
 
  Released under the GNU General Public License
  ------------------------------------------------------------------------------
  Paypal-Spenden willkommen: donation@ctm21.de
  ------------------------------------------------------------------------------
  LICENSE

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License (GPL)
  as published by the Free Software Foundation;

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ------------------------------------------------------------------------------
  based on:
  (c) 2000-2001 The Exchange Project  (earlier name of osCommerce)
  (c) 2002-2003 osCommerce    - www.oscommerce.com
  (c) 2003      nextcommerce  - www.nextcommerce.org
  (c) 2003      XT-Commerce   - www.(( Wir dulden keine kommerziellen Werbelinks - Bitte <a href="index.php?topic=3013.0">Forenregeln</a> beachten! ))

  Released under the GNU General Public License
  ------------------------------------------------------------------------------
*/


/*  TTO
    Kernfunktion tt_random
    Aufruf im Template über {tt_random parameter="text"}
    Mögliche Parameter und Folgen
    max     =>  Wert    =>  Maximale Anzahl an Zufallsartikeln
    tpl     =>  String  =>  Template, wird im Unterordner tt_plugins gesucht
                            Namenskonvention: tt_random_tpl.html
                            Beispiel:
                            {tt_random tpl="zweispaltig"}
                            =>  tt_random_zweispaltig.html
    cat     =>  CatID   =>  Kategorie
                        NEU Durch Kommata getrennte Liste
                            leer oder 0   =>  Nur die Aktuelle Kategorie
                                          =>  Alle, wenn keine Kategorie aktiv
    catex   =>  CatID   =>  Kategorie, die auszuschließen ist
                        NEU Durch Kommata getrennte Liste
    ToDo
    subcat  =>  true    =>  Unterkategorien einbeziehen
 
*/
function smarty_function_tt_random($params, &$smarty) {

/*  TTO
    Hier Standardwert für die Anzahl der auszugebenden Angebote definieren*/
$tt_default_limit = 4;

/*  TTO
    Hier Standardsortierungfestlegen
    "rand"      =>  Zufall
    "datedesc"  =>  neueste zuerst
    "remaining" =>  noch nicht implementiert
     */

/*  TTO
    Anzahl der Auszugebenden Angebote */
if( (int) $params['max']){
  $tt_q_limit = 'LIMIT '. $params['max'];
} else {
  $tt_q_limit = 'LIMIT '. $tt_default_limit;
}

/*  TTO
    Überprüfung, ob alle Angebote ausgegeben werden sollen */
if($params['all']== 'true'){
  $tt_q_limit = '';
}

/*  TTO
    FSK */
$fsk_lock = '';
if ($_SESSION['customers_status']['customers_fsk18_display'] == '0') {
  $fsk_lock = ' AND p.products_fsk18!=1';
}

/*  TTO
    Group-Check */
if (GROUP_CHECK == 'true') {
  $group_check = " AND p.group_permission_".$_SESSION['customers_status']['customers_status_id']."=1 ";
}

/*  TTO
    Ist eine Kategorie auszuschließen?*/
if($params['catex']){
  $tt_catexarray = explode(',',$params['catex']);
  $tt_catexcount = count($tt_catexarray);
  $tt_catexclude='';
    if($tt_catexcount==1){
      $tt_catexclude = 'AND p2c.categories_id !="'. $params['catex'].'" ';
    } else{
      $tt_catexclude='';
      foreach($tt_catexarray as $tt_catex){
        $tt_catexclude .= 'AND p2c.categories_id !="'.$tt_catex.'" ';
      }
  }
}
   

/*  TTO
    Zufallsprodukte holen
    Wenn keine cat übergeben, schauen, wo man ist
    und entweder aktuelle Kategorie  oder alles ausgeben */
if(!$params['cat']){
  $tt_cPath = preg_replace('/[^0-9_]/','',$GLOBALS['cPath']);
  $tt_category_path = explode('_',$tt_cPath);
  $tt_category_id = array_pop($tt_category_path);
  if($tt_category_id){
    $tt_selectcat = 'AND p2c.categories_id ="'.$tt_category_id.'" ';
    $tt_random = tt_random_get_byCategory($tt_q_limit, $fsk_lock, $group_check, $tt_selectcat, $tt_catexclude);
  } else {
    $tt_random = tt_random_get($tt_q_limit, $fsk_lock, $group_check, $tt_catexclude);
  }
} else {
/*  TTO
    Kategorie-Liste*/
  $tt_catarray = explode(',',$params['cat']);
  $tt_catcount = count($tt_catarray);
  if($tt_catcount==1){
    $tt_selectcat = 'AND p2c.categories_id ="'. $params['cat'].'" ';
    $tt_random = tt_random_get_byCategory($tt_q_limit, $fsk_lock, $group_check, $tt_selectcat, $tt_catexclude);
  } else {
    $i=0;
    $tt_selectcat ='AND ( ';
    foreach($tt_catarray as $tt_cat){
      $i++;
      $tt_selectcat .= 'p2c.categories_id ="'.$tt_cat.'" ';
      if($i<$tt_catcount){
        $tt_selectcat .= 'OR ';
      }
    }
    $tt_selectcat .= ')';
    $tt_random = tt_random_get_byCategory($tt_q_limit, $fsk_lock, $group_check, $tt_selectcat, $tt_catexclude);
  }
}

/*  TTO
    hier aufhören, wenn keine Artikel  */
if(!$tt_random){
  return false;
}

/*  TTO
    Template prüfen
    und bei nicht vorhandenem Parameter das Default-Template wählen */
if(!$params['tpl']){
  $params['tpl'] = 'default';
}

$tt_random_template = tt_random_getTemplate($params['tpl']);

/*  TTO
    Smarty-Objekt initialisieren */
$tt_random_smarty = new smarty;    
/*  TTO
    Admin-Warnungen ausgeben */
if ($_SESSION['customers_status']['customers_status_id'] == 0){
  if($tt_random_template['warning']){
    $tt_random_smarty->assign('ADMINWARNING', $tt_random_template['warning']);
  }
}
/*  TTO
    Standardwerte zuweisen  */
$tt_random_smarty->assign('tpl_path', 'templates/'.CURRENT_TEMPLATE.'/');
$tt_random_smarty->assign('language', $_SESSION['language']);

/*  TTO
    Ergebnis zuweisen */
$tt_random_smarty->assign('tt_random', $tt_random);
$tt_random_smarty->assign('tt_catex', $tt_catexclude);


/*  TTO
    Ergebnis ausgeben */
$output = $tt_random_smarty->fetch($tt_random_template['tpl']);

return $output;

}

/*  TTO
    Standardabfrage Zufallsartikel  */
function tt_random_get($tt_q_limit, $fsk_lock, $group_check, $tt_catexclude){

$tt_rand = new product();

$tt_random_query = "SELECT DISTINCT p.products_id,
                              pd.products_name,                            
                              p.products_price,
                              p.products_tax_class_id,                          
                              p.products_image,                            
                              p.products_fsk18 from ".TABLE_PRODUCTS." p, ".TABLE_PRODUCTS_DESCRIPTION." pd, ".TABLE_PRODUCTS_TO_CATEGORIES." p2c
                        WHERE p.products_status = '1'
                        AND   p.products_id = pd.products_id
                       AND    p2c.products_id = p.products_id "
                              .$tt_catexclude."
                              ".$group_check."
                              ".$fsk_lock."
                        AND   pd.language_id = '".(int) $_SESSION['languages_id']."'
                        ORDER BY RAND()". $tt_q_limit;

$tt_random_query_do = xtDBquery($tt_random_query);

$tt_random=array();
while ($tt_random_q_result = xtc_db_fetch_array($tt_random_query_do)) {
  $tt_random[] = $tt_rand->buildDataArray($tt_random_q_result);
}

return $tt_random;

}

/*  TTO
    Zufallsartikel aus einer bestimmten Kategorie  */
function tt_random_get_byCategory($tt_q_limit, $fsk_lock, $group_check, $tt_selectcat, $tt_catexclude){

$tt_rand = new product();

$tt_random_query = "SELECT DISTINCT p.products_id,
                              pd.products_name,
                              p.products_price,
                              p.products_tax_class_id,                            
                              p.products_image,                            
                              p.products_fsk18
                       FROM   ".TABLE_PRODUCTS." p, ".TABLE_PRODUCTS_DESCRIPTION." pd, ".TABLE_PRODUCTS_TO_CATEGORIES." p2c
                       WHERE  p.products_status = '1'
                       AND    p.products_id = pd.products_id
                       AND    p2c.products_id = p.products_id "
                              .$tt_selectcat
                              .$tt_catexclude
                              .$group_check
                              .$fsk_lock."
                       AND pd.language_id = '".(int) $_SESSION['languages_id']."'
                       ORDER BY RAND()". $tt_q_limit;

$tt_random_query_do = xtDBquery($tt_random_query);

$tt_random=array();
while ($tt_random_q_result = xtc_db_fetch_array($tt_random_query_do)) {
  $tt_random[] = $tt_rand->buildDataArray($tt_random_q_result);
}

return $tt_random;

}

/*  TTO
    Nachsehen, ob das angegebene Template existiert  
    Notfalls das mitgelieferte ausgeben */
function tt_random_getTemplate($tpl){

  $tt_random_template = array();

  $tt_tpl_tocheck = 'tt_random_' . $tpl . '.html';

/*  TTO
    Wenn Template existiert, dann zurückgeben und gut is */
  if (file_exists('templates/' . CURRENT_TEMPLATE . '/module/tt_random/' . $tt_tpl_tocheck)){
    $tt_random_template = array('tpl'  => CURRENT_TEMPLATE . '/module/tt_random/' .$tt_tpl_tocheck);
    return $tt_random_template;
  }

/*  TTO
    Wenn Template nicht existiert und nicht default hieß,
    dann nochmal nach dem default schauen */
  if($tpl!='default'){
    if (file_exists('templates/' . CURRENT_TEMPLATE . '/module/tt_random/tt_random_default.html')){
    $tt_random_template = array('tpl'      =>  CURRENT_TEMPLATE.'/module/tt_random/tt_random_default.html',
                                   'warning'  =>  'Das angegebene Template tt_random_'.$tpl.'.html existiert nicht!');
    return $tt_random_template;
    }
  }
 
/*  TTO
    Wenn wir jetzt immer noch nicht zurück sind,
    fehlen die Templates komplett */
  if($tpl='default'){
    $tt_random_template = array('tpl'      => 'tt_default/tt_random/tt_random_default.html',
                                'warning'  => 'Es existiert kein Template für die Ausgabe der Zufallsartikel!');
    return $tt_random_template;
  }

  return false;

}


?>
 

Danke für Tips/Hinweise

[Jürgen]

Wenn ich das Plugin wie beschrieben mit {dynamic}{tt_random}{/dynamic} aufrufe erhalte ich folgenden Fehler im log....

Code: XML  [Auswählen]

[2021-08-22 12:29:21]   [error] [modified]      [pid:39765]     ERROR found for URL: /test::1234.html   {}      {}
[2021-08-22 12:29:21]   [error] [modified]      [pid:39765]     Syntax error in template "/XXX/XXX/XX/XXXXX/htdocs/XXX.x/templates/XXX/module/product_info/product_info_v1_new - Copy.html"  on line 223 "{dynamic}{tt_random}{/dynamic}" unknown tag "dynamic" in File: /XXX/XXX/XXX/XXX/XXX.x/includes/external/smarty/smarty_3/sysplugins/smarty_internal_templatecompilerbase.php on Line: 223      {}      {}

Kann man das cachen für dieses Plugin auch irgendwie "global" im zugehörigen Code deaktivieren....?

{nocache}{tt_random} {/nocache} funktioniert leider auch nicht.....

Das Plugin ist toll, es macht jedoch für mich begrenzt Sinn bei jedem Artikelwechsel dieselben Artikel zu sehen....

Danke für Tips/Hilfe

[karsta.de]

Lass mal das dynamic weg und lege mal die function.tt_random.php in dein templates/[DEIN_TEMPL]/smarty Ordner.
Wie äußert sich denn dein cache-Problem, weiße Seite?
Ich verwende ein erweitertes Script und mir sind bisher keine cache-Probleme aufgefallen.

BG Karsta