Différences

Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.

Lien vers cette vue

projet:developpement:v24 [2012/05/12 20:05]
flop25 créée
projet:developpement:v24 [2013/05/13 19:21] (Version actuelle)
flop25 [Les dérivés (Tailles multiples)]
Ligne 1: Ligne 1:
-====== Technical changes in Piwigo 2.4 ======+====== Changements techniques dans Piwigo 2.4 ======
  
-This page lists the technical changes that may be useful for plugin and theme developpers to make their extension compatible with Piwigo 2.4.+Retrouvez ici tous les changements techniques pour la version 2.4, notamment les changements susceptibles d’intéresser les créateurs d'extensions, ainsi que les utilisateurs lambda ayant créé leur plugin perso, un template, leur thème perso...
  
-===== replace $conf['local_data_dir'] with $conf['data_location']  =====  
  
-See http://piwigo.org/forum/viewtopic.php?id=18582+===== $conf['local_data_dir'] remplacé par $conf['data_location']  ===== 
  
-===== Derivatives (multiple size) =====  +Pour plus d'infos en anglais : http://piwigo.org/forum/viewtopic.php?id=18582\\ 
-==== Database  ==== +résumé il est devenu important de séparer le dossier local/qui contient les fichiers de personnalisation à sauvegarderet le dossier _data/ qui contient les fichiers temporaires tels les CSS et js combiné et minifiés, ainsi que le cache des images redimensionnées à la volée.
-==== Core functions  ==== +
-  * get_thumbnail_location - removed +
-  * get_thumbnail_path - removed +
-  * get_thumbnail_url - deprecated (it will not be there in 2.5) - use Derivative_Image::thumb_url +
-  * get_high_locationget_high_pathget_high_url - removed +
-  * get_image_location - removed +
-  * get_image_path - removed - use ( new SrcImage($infos) )->get_path() +
-  * get_image_url - removed - use ( new SrcImage($infos) )->get_url() +
-  * file_path_for_type - removed+
  
-==== Triggers  ==== + 
-=== Removed  === +===== Les dérivés (Tailles multiples) =====  
-  * get_thumbnail_location, get_thumbnail_url+ 
 +Principe : les images originales ne sont pas touchées et placées dans /galleries/ ou /upload/ selon la méthode d'envoi utilisée. Dans l'administration, la page "Configuration > Options > Tailles de photo" regroupe les tailles 'officielles' disponibles aux utilisateur pour chaque image. Les images redimensionnées sont placées dans le dossier _data/i/. Quasiment toutes les références Php ou Smarty aux url, chemins, tailles... des images (miniatures ou non) sont à mettre à jour pour Piwigo 2.4.\\ 
 + 
 +<WRAP center round important 60%> 
 +La mise à jour 2.4 déplace les fichiers : les images contenus dans les dossiers /pwg_high sont remontées d'un cran, afin de remplacer les images taille web d'autrefois.\\ 
 +Les dossiers /thumbnails et /pwg_high n'ont plus d'utilité mais ne sont pas encore supprimés. En effet, ils seront supprimés lors d'une mise à jour 2.x : le processus de mise à jour de la 2.4.0 a été allégé, en n'incluant pas la suppression de ces dossiers (et leur contenu avec). 
 +</WRAP> 
 + 
 + 
 +NB : un dérivé = un ensemble d'infos pour redimensionner suivant une taille (hauteur, largeur, recadrage...) 
 + 
 + 
 +==== Base de données ==== 
 + 
 +FIXME à écrire 
 + 
 + 
 +==== Fonctions  ===
 + 
 +  * get_thumbnail_location - supprimé 
 +  * get_thumbnail_path - supprimé 
 +  * get_thumbnail_url - déprécié(sera supprimé pour la 2.5) - utilisez Derivative_Image::thumb_url 
 +  * get_high_locationget_high_path, get_high_url - supprimé 
 +  * get_image_location - supprimé 
 +  * get_image_path - supprimé- utilisez( new SrcImage($infos) )->get_path() 
 +  * get_image_url - supprimé- utilisez( new SrcImage($infos) )->get_url() 
 +  * file_path_for_type - supprimé\\ 
 +<wrap info>__NB__ :</wrap>pour une liste des fonctions ajoutées, voyez le paragraphe //En pratique comment faire ?// 
 + 
 + 
 +==== Déclencheurs (Tiggers) ==== 
 + 
 +=== Supprimé === 
 +  * get_thumbnail_location 
 +  * get_thumbnail_url
   * get_element_location   * get_element_location
  
-=== Added  === +=== Ajouté === 
-get_mimetype_location (replaces get_thumbnail_location)+get_mimetype_location (remplace get_thumbnail_location) 
 + 
 + 
 +==== En pratique comment faire ? ==== 
 + 
 +comment mettre à jour vos .tpl : 
 +  * pour définir une taille d'image, à partir d'une taille 'officielle' existante : {define_derivative name='//NOM//' type='//TYPE//'} où NOM est le nom du dérivé à définir (à utiliser par la suite avec $pwg->derivative($//NOM//, $//src-image//) ), et //TYPE// correspond au dérivé déjà existant. //TYPE// peut avoir les valeurs suivantes : square, thumb, 2small, xsmall, small, medium, large, xlarge, xxlarge.\\ <wrap info>__Rappel__ :</wrap>  les tailles correspondant à ces dérivés sont définis et modifiables sur la page "Configuration > Options > Tailles de photo". 
 +  * pour définir un nouveau dérivé : {define_derivative name='//NOM//' width='//LARGEUR//' height='//HAUTEUR//' crop=//true/false// min_height='//HAUTEUR_MIN//' min_width='//LARGEUR_MIN//'} où NOM est le nom du dérivé qui est créé (à utiliser par la suite avec $pwg->derivative($//NOM//, $//src-image//) ), //LARGEUR// et //HAUTEUR// sont requis et doivent être des valeurs numériques, le paramètre 'crop' est optionel (recadrage, par défaut false), et les paramètres min_width et min_height sont aussi optionnels (valeurs numériques) 
 +  * pour obtenir l'url d'une image redimensionnée selon le dérivé //NOM// : {$pwg->derivative_url($//NOM//, '//image source//')} OU {assign var=//mon_dérivé// value=$pwg->derivative($//NOM//, '//image source//')} et {$//mon_dérivé//->get_url()} 
 + 
 +**Listes des fonctions nouvelles**, à utiliser ainsi {$//mon_dérivé//->fonction()} : 
 +  * get_path() retourne le chemin vers l'image redimensionnée 
 +  * get_url() retourne l'url de l'image redimensionnée 
 +  * same_as_source() retourne vrai si l'image retournée est la même que l'original 
 +  * get_type() retourne 'Orignal' ou '//Type//' où type prend les valeurs parmi 'square', 'thumb', '2small', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'xxlarge' et'custom' 
 +  * get_size() retourne la taille de l'image redimensionnée dans un tableau : Array { '//LARGEUR//', '//HAUTEUR//'} 
 +  * get_size_htm() retourne la chaîne 'width="'.$size[0].'" height="'.$size[1].'"' 
 +  * get_size_hr() retourne la chaîne $size[0].' x '.$size[1] 
 +  * get_scaled_size($maxw, $maxh) a besoin comme argument de la largeur max et la hauteur max, et retourne les nouvelles dimensions dans le cas d'un redimensionnement à l'échelle. 
 +  * get_scaled_size_htm($maxw=9999, $maxh=9999) retourne la chaîne 'width="'.$size[0].'" height="'.$size[1].'"' où le tableau $size correspond aux dimensions retournées par get_scaled_size($maxw, $maxh) 
 +  * is_cached() retourne vrai/true si l'image redimensionnée existe déjà (dans le cache _date/i/) ou faux/false si l'image redimensionnée  a besoin d'être créée via i.php
  
-==== How To  ==== +Liste des fonctions disponibles comme fonction smarty cad {$pwg->function($//NOM//, '//image source//')} 
-how to update your .tpl files : +  * derivative_url($type$imgretourne l'url de l'image redimensionnée
-  * to define a size using an default size : {define_derivative name='//NAME//' type='//TYPE//'} where NAME is the name of the derivative created (use it like $pwg->derivative($//NAME//, $//src-image//), and //TYPE// can have the values : square, thumb, 2small, xsmall, small, medium, large, xlarge, xxlarge. The sizes corresponding to these types are available in  Configuration -> Options -> Photo sizes +
-  * to define a new size : {define_derivative name='//NAME//' width='//WIDTH//' height='//HEIGHT//' crop=//true/false// min_height='//MIN_HEIGHT//' min_width='//MIN_WIDTH//'where NAME is the name of the derivative created (use it like $pwg->derivative($//NAME//, $//src-image//), //WIDTH// and //HEIGHT// are required and must be numeric values, the attribute crop is optional (default value false), and the attributes min_width and min_height are also optional (only numeric value) +
-  * to get a url of a picture according to the //NAME// derivative  : {$pwg->derivative_url($//NAME//'//src of the original picture//')} OR {assign var=//my_derivative// value=$pwg->derivative($//NAME//, '//src of the original picture//')} with {$//my_derivative//->get_url()}+
  
-List of functions available as {$//my_derivative//->function()} : 
-  * get_path() returns the path of the resized picture 
-  * get_url() ) returns the url of the resized picture 
-  * same_as_source() returns true if the picture has not been resized 
-  * get_type() returns 'Orignal' or 'Type' where type can be 'square', 'thumb', '2small', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'xxlarge' and 'custom' 
-  * get_size() returns the size of the derivative image as an array : Array { '//width//', '//height//'} 
-  * get_size_htm() return the string 'width="'.$size[0].'" height="'.$size[1].'"' 
-  * get_size_hr() returns the string $size[0].' x '.$size[1] 
-  * get_scaled_size($maxw, $maxh) needs maximum width and maximum height, and returns the new size needed for a scaled reduction 
-  * get_scaled_size_htm($maxw=9999, $maxh=9999) returns the string 'width="'.$size[0].'" height="'.$size[1].'"' where the array size is the size returned by get_scaled_size($maxw, $maxh) 
-  * is_cached() returns true if the resized picture exists or need to be created via i.php : useful for Ajax loading 
  
-List of functions available as template function ie {$pwg->function($//NAME//, '//src of the original picture//')} +===== Page admin de modification d'album (cat_modify=====
-  * derivative_url($type, $imgreturns the url of the resized picture+
  
-===== Album administration screen (cat_modify) =====+Ce n'est plus admin.php?page=cat_modify&cat_id=1234, mais admin.php?page=album-1234 désormais
  
-There is no longer admin.php?page=cat_modify&cat_id=1234, use instead admin.php?page=album-1234+Pour admin.php?page=cat_perm&cat=1234, utilisez admin.php?page=album-1234-permissions désormais
  
-For admin.php?page=cat_perm&cat=1234, use instead admin.php?page=album-1234-permissions 
  
-===== CSS classes renamed on comment_list.tpl ===== +===== CSS classes renommées on comment_list.tpl =====
-//.thumbnailCategories// is renamed into //.commentsList//+
  
-//.thumbnailCategory// is renamed into //.commentElement//+//.thumbnailCategories// est renommée en //.commentsList//\\ 
 +//.thumbnailCategory// est renommée en  //.commentElement//
 
Haut de page
projet/developpement/v24.1336853132.txt.gz · Dernière modification: 2012/05/12 20:05 par flop25
 
 
github twitter newsletter Faire un don Piwigo.org © 2002-2021 · Contact