piouPiouM's dev» Archives pour le tag media – piouPiouM's dev http://pioupioum.fr Bloc-note d'un développeur web Thu, 29 Jul 2010 16:47:44 +0000 en hourly 1 WordPress : autoriser l’upload de fichiers au format non-supporté http://pioupioum.fr/snippets/wordpress-autoriser-upload-media-format-inconnu.html http://pioupioum.fr/snippets/wordpress-autoriser-upload-media-format-inconnu.html#comments Tue, 09 Feb 2010 14:50:30 +0000 piouPiouM http://pioupioum.fr/?p=316

WordPress ne supporte en upload qu’une liste exhaustive de formats de fichiers. Si comme moi vous souhaitez uploader1 des fichiers issus de TextMate, comme les .tmCommand et autres .tmSnippet, ajoutez le code qui suit dans le fichier functions.php de votre thème2.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

<?php
// Add the new filter
add_filter('upload_mimes', 'addUploadMimes');
 
/**
 * Adds new supported media types for upload.
 *
 * @see wp_check_filetype() or get_allowed_mime_types()
 * @param array $mimes Array of mime types keyed by the file extension regex corresponding to those types.
 * @return array
 */
function addUploadMimes($mimes)
{
	$mimes = array_merge($mimes, array(
		'tmbundle|tmCommand|tmDragCommand|tmSnippet|tmLanguage|tmPreferences' => 'application/octet-stream'
	));
 
	return $mimes;
}
?>

Indiquez en clé les nouvelles extensions de fichier (séparées par des pipes) et en valeur le type mime associé.

Continuez votre lecture sur des sujets similaires

  1. sous Mac OS X tout du moins, SWFUpload me désactive la sélection des fichiers de TextMate m’obligeant à passer par l’interface d’upload native du navigateur. Je suis preneur de toute solution. ↩

  2. à choisir, l’ajouter dans un plugin serait plus judicieux puisque cette fonctionnalité ne dépend pas du thème. ↩

]]> http://pioupioum.fr/snippets/wordpress-autoriser-upload-media-format-inconnu.html/feed/ 1 WordPress : récupération avancée des images d’un article http://pioupioum.fr/outils-astuces/wordpress-recuperation-avancee-images-article.html http://pioupioum.fr/outils-astuces/wordpress-recuperation-avancee-images-article.html#comments Tue, 15 Sep 2009 00:11:27 +0000 piouPiouM http://pioupioum.fr/?p=245

De nombreux thèmes WordPress proposent, via un champ personnalisé, une gestion des miniatures à afficher sur la page d’accueil. Mais pourquoi contraindre ses rédacteurs à cette manipulation, qui, il faut le dire, est relativement lourde,surtout pour le néophyte1. Le plus simple serait de recourir dans son thème à une fonction qui automatiserait la recherche de l’image à afficher en tant que thumbnail.

Évidemment, nous pouvons trouver au détour du web des fonctions au code douteux2 qui vont se contenter de chercher la première image dans le contenu du billet.

Pourquoi ne pas étendre (et améliorer tant que nous y sommes =) ce type de fonction afin d’obtenir un outil de recherche d’images au sein d’un billet ? C’est ce que je vous propose ici.

Table des matières

  1. Code source
  2. Fonctionnement
  3. Exemples d’utilisation
  4. Liste des paramètres
  5. Historique des versions et changelog

Code source

Copiez le code qui suit dans le fichier functions.php de votre thème.

Télécharger wp-get_post_images.phps (1.62 Ko)

Fonctionnement

Petit retour sur ce code non commenté3, car, à la lecture aisée.

Recherche des images

La fonction get_post_images va effectuer une recherche d’image(s) dans les images jointes au billet cible si l’ordre de tri est différent à natural. En effet, cette option oblige à parser le contenu dans le sens de lecture de l’article, qui peut différer de l’ordre d’ajout des images dans sa bibliothèque de médias.
Notez que la recherche non naturelle prend directement en compte les ordres de tri.

Si la recherche échoue (ou si l’ordre de tri est défini à natural), le contenu du post est analysé. Seront considérées les images comportants une classe wp-image-(\d+). Si la recherche s’avère fructueuse, le tri est appliqué.

Finalement, get_post_images retournera le résultat de la recherche au format spécifié via le paramètre output. En cas d’échec, le booléen false est retourné.

Quid de la présentation ?

Le formatage et l’affichage des données est laissé à la discrétion du développeur. La présentation pourra ainsi évoluer indépendamment de la fonction.

Exemples d’utilisation

Récupérer les images triées par date (défaut)

Nous supposons ici que l’action se déroule dans la boucle puisque qu’aucun identifiant d’article n’a été fourni. Autrement, la valeur de retour sera FALSE.

<?php get_post_images(); ?>

Liste des images triées par date inverse

<?php get_post_images('order=DESC'); ?>

Liste des images triées par ordre d’arrivée dans le billet

<?php get_post_images('orderby=natural'); ?>

Récupération de la première image

<?php get_post_images('number=1'); ?>

Récupération de la première image (par contenu, forcé)

<?php get_post_images('number=1&orderby=natural'); ?>

Afficher la miniature de la première image d’un article

La fonction first_thumbnail qui suit affichera au format thumbnail la première image du billet ayant pour identifiant $post_id. Si ce dernier est omit, l’identifiant du billet en cours d’itération depuis la boucle sera utilisé.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

/**
 * Display thumb of the first image from a post.
 *
 * @author Mehdi Kabab <http://pioupioum.fr>
 * @copyright Copyright (C) 2009 Mehdi Kabab
 * @license http://www.gnu.org/licenses/gpl.html  GNU GPL version 3 or later
 *
 * @param  array $post_id Optional. Post ID.
 * @return bool False on failure.
 */
function first_thumbnail($post_id = null)
{
    $img = get_post_images("post_id=$post_id&number=1");
    if (false !== $img)
    {
        echo wp_get_attachment_link($img[0]->ID, 'thumbnail');
    }
    else
    {
        return false;
    }
}

Générer une miniature de la première image d’un article avec timthumb

La même fonction mais qui fait appel à timthumb pour générer une miniature aux dimensions arbitraires.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

/**
 * Display a dynamic thumbnail of the first image from a post.
 *
 * The defaults are as follows:
 *     'post_id' - Default is null. Post ID.
 *     'h' - Default is null. Thumbnail height.
 *     'w' - Default is null. Thumbnail width.
 *     'q' - Default is null. Thumbnail quality.
 *     'zc' - Default is null. Zoom crop used for generates the thumbnail.
 *
 * @author Mehdi Kabab <http://pioupioum.fr>
 * @copyright Copyright (C) 2009 Mehdi Kabab
 * @license http://www.gnu.org/licenses/gpl.html  GNU GPL version 3 or later
 *
 * @link http://code.google.com/p/timthumb/ Timthumb
 *
 * @param  array $args Optional. Overrides defaults.
 * @return bool False on failure.
 */
function first_thumbnail($args = array())
{
    $defaults = array(
        'post_id' => null,
        'h'  => null,
        'q'  => null,
        'w'  => null,
        'zc' => null,
    );
    $args    = wp_parse_args($args, $defaults);
    $post_id = $args['post_id'];
    $img     = get_post_images("post_id=$post_id&number=1");
    unset($args['post_id']);
 
    if (false !== $img)
    {
        $img = $img[0];
 
        if (null === $post_id)
        {
            if (in_the_loop())
            {
                global $post;
                $post_id = $post->ID;
            }
            else
            {
                if (isset($img->post_parent))
                {
                    $post_id = $img->post_parent;
                }
                else
                {
                    return false;
                }
            }
        }
        $query     = http_build_query($args, '', '&amp;');
        $thumbnail = sprintf('<img src="%s?src=%s%s" rel="attachment"%s%s/>',
            get_bloginfo('template_url', 'display') . '/timthumb.php', // customize timthumb url
            $img->guid,
            ($query) ? '&amp;' . $query : '',
            (isset($args['w'])) ? " width=\"{$args['w']}\"" : '',
            (isset($args['h'])) ? " height=\"{$args['h']}\"" : ''
        );
 
        printf('<a href="%s" title="%s">%s</a>',
            get_permalink($post_id),
            esc_attr(get_the_title($post_id)),
            $thumbnail
        );
    }
    else
    {
        return false;
    }
}

Ainsi, pour afficher une miniature de 260x120 pixels de la première image de l’article courant nous utiliserons :

<?php first_thumbnail('w=260&h=120'); ?>

Liste des paramètres

Voici la liste des paramètres acceptés par l’argument $args de la fonction get_post_images :

number
(integer) (optionnel) Le nombre maximal d’images à retourner. Par défaut à -1, retourne toutes les images.

order
(string) (optionnel) Ordre de tri. Les valeurs valides sont :

  • 'ASC' - Croissant (du plus petit au plus grand). (Par défaut)
  • 'DESC' - Décroissant (du plus grand au plus petit).

orderby
(string) (optionnel) Ordonner les images par l’une des valeurs qui suivent :

  • 'date' - Trier selon la date de création. (Par Défaut)
  • 'post_id' - Trier numériquement par l’ID des articles.
  • 'natural' - Trier selon l’affichage des images dans le contenu de l’article.

output
(string) (optionnel) Le format de sortie.

  • OBJECT - Retourne un tableau d’objets instances de la classe stdClass. (Par défaut)
  • ARRAY_A - Retourne un tableau associatif (nom des champs => valeurs).
  • ARRAY_N - Retourne un tableau indexé numériquement de la valeur des champs.

post_id
(integer) (optionnel) L’identifiant de l’article à analyser. Par défaut à NULL, utilise celui du billet courant dans la boucle.

preserve_keys
(boolean) (optionnel) Préserver les clés retournées par l’API de WordPress, c.-à-d les identifiants des images. Par défaut à FALSE, le tableau résultat est indexé numériquement à partir de 0.

Historique des versions et changelog

1.0.0

  • Version initiale.

Continuez votre lecture sur des sujets similaires

  1. uploader l’image, récupérer son URL relative donc en supprimer la racine du site, ajouter un champ personnalisé pour y renseigner l’URL précédemment copiée. ↩

  2. franchement, que d’erreurs dans cette fonction qui a pourtant fait du bruit : la temporisation n’est d’aucune utilité, la globale $posts ne sert à rien, une Notice est générée lorsque l’article ne contient pas d’image, l’auteur de la fonction sait qu’il recherche 1 image alors pourquoi recourir à preg_match_all au lieu d’un simple preg_match ? C’est court donc c’est cool, c’est ça ? (‘o_o) ↩

  3. vous pouvez me flageller :-P  ↩

]]> http://pioupioum.fr/outils-astuces/wordpress-recuperation-avancee-images-article.html/feed/ 17 WordPress : lister les images d’un article sur une page media http://pioupioum.fr/outils-astuces/afficher-images-article-page-media.html http://pioupioum.fr/outils-astuces/afficher-images-article-page-media.html#comments Wed, 26 Aug 2009 15:04:50 +0000 piouPiouM http://pioupioum.fr/?p=207

Julien a présenté ce 25 août 2009 une fonction d’affichage des miniatures liées à un même article pour WordPress. Bien que fonctionnelle, elle ne se révèle pas être des plus pratique.

Note :
J’écris ici même parce qu’en fin de billet je colle une fonction qui ferait un peu pavé dans les commentaires de l’article de Julien. Je ne fais également plus confiance aux services de pasties en ligne, ayant perdu trop d’extraits de code…

Comme le relève OncleTom, la présentation et la logique sont mélangées.
La fonction wallthumb dispose d’un argument $id qui est finalement inutile. Il sert simplement à tester la vignette courante, mais, comme la fonction est à appeler sur la page d’un media, l’élément courant est obligatoirement le media affiché.
Enfin, les arguments de présentation cassent avec la logique introduite par WordPress. Dans son API, ce dernier fait généralement appel à un unique argument1, passé sous la forme d’un tableau ou d’une chaîne de caractères.

Ci-dessous, une fonction de remplacement à ajouter dans le fichier functions.php de votre thème.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

<?php
/**
 * Retrieve the list of images attached to the same post that the current attachment.
 *
 * @author Mehdi Kabab <http://pioupioum.fr>
 * @copyright Copyright (C) 2009 Mehdi Kabab
 * @license http://www.gnu.org/licenses/gpl.html  GNU GPL version 3 or later
 *
 * @link http://www.webinventif.fr/wordpress-afficher-toutes-miniatures-liees-article-pages-media/ Inspiration
 *
 * @param  string $output Optional. Constant for return type, either OBJECT (default), ARRAY_A, ARRAY_N.
 * @return array|bool False on failure
 **/
function get_other_attachments($output = OBJECT)
{
    global $post;
    if (!is_attachment() || false === (bool) $post->post_parent)
        return false;
 
    $attachments = get_children(array(
        'post_type'      => 'attachment',
        'post_mime_type' => 'image',
        'post_status'    => 'inherit',
        'post_parent'    => $post->post_parent
    ), $output);
 
    return $attachments;
}
 
/**
 * Display the HTML list of images attached to the same post that the current attachment.
 *
 * Only works on an attachment page.
 *
 * @author Mehdi Kabab <http://pioupioum.fr>
 * @copyright Copyright (C) 2009 Mehdi Kabab
 * @license http://www.gnu.org/licenses/gpl.html  GNU GPL version 3 or later
 *
 * @link http://www.webinventif.fr/wordpress-afficher-toutes-miniatures-liees-article-pages-media/ Inspiration
 *
 * @param  string|array $args Optional. User defined arguments for replacing the defaults.
 * @return bool False on failure.
 */
function wallthumb($args = array())
{
    global $post;
    $attachments = get_other_attachments();
    if (!$attachments)
        return false;
 
    $defaults = array(
        'id'            => 'gallery-%d',
        'current_class' => 'current',
        'thumb_class'   => 'gallerythumb',
        'before_thumb'  => '<li class="%s">',
        'after_thumb'   => '</li>',
        'before_list'   => '<ul id="%s">',
        'after_list'    => '</ul>',
    );
    $args        = wp_parse_args($args, $defaults);
    $current_id  = $post->ID;
    $thumb_class = trim($args['thumb_class']);
 
    static $i = 0;
    $stack = array(sprintf($args['before_list'], sprintf($args['id'], ++$i)));
    foreach ($attachments as $attachment)
    {
        if ($current_id != $attachment->ID)
        {
            $buf = sprintf($args['before_thumb'], $thumb_class);
        }
        else
        {
            $buf = sprintf($args['before_thumb'], trim($thumb_class . ' ' . $args['current_class']));
        }
        $buf .= sprintf('<a href="%s" title="%s" rel="attachment">%s</a>',
            get_attachment_link($attachment->ID),
            esc_attr(get_the_title($attachment->ID)),
            wp_get_attachment_image($attachment->ID, 'thumbnail')
        );
        $buf .= $args['after_thumb'];
        $stack[] = $buf;
    }
    echo implode("\n\t", $stack) . "\n{$args['after_list']}";
}

Continuez votre lecture sur des sujets similaires

  1. Voir la fonction register_sidebar par exemple. ↩

]]> http://pioupioum.fr/outils-astuces/afficher-images-article-page-media.html/feed/ 10