¿Cómo configuro una imagen destacada (miniatura) por URL de imagen cuando uso wp_insert_post ()?

Mientras miraba a través de la entrada de referencia de función para wp_insert_post () , noté que no hay ningún parámetro en la matriz que requiera que me permita establecer la 'Imagen destacada' para una publicación, que se muestra como la miniatura de la publicación en mi tema.

He examinado funciones como set_post_thumbnail () , como lo sugirió el Sr. Bennett, pero esta parece ser una adición relativamente nueva a WordPress en sí y al códice de WordPress. Como tal, no hay ninguna fuente que pueda encontrar que explique cómo se debe adquirir y suministrar el parámetro $ thumbnail_id. Si esta es realmente la función a utilizar, ¿de qué manera podría proporcionarle un parámetro válido $ thumbnail_id cuando todo lo que tengo es una URL de imagen?

¡Gracias por adelantado!

Puede configurar una imagen como miniatura de publicación cuando está en su biblioteca de medios. Para agregar una imagen en su biblioteca de medios, debe cargarla en su servidor. WordPress ya tiene una función para poner imágenes en su biblioteca de medios, solo necesita un script que cargue su archivo.

Uso:

Generate_Featured_Image( '../wp-content/my_image.jpg', $post_id );

// $post_id is Numeric ID... You can also get the ID with:
wp_insert_post()

Función:

function Generate_Featured_Image( $image_url, $post_id  ){
    $upload_dir = wp_upload_dir();
    $image_data = file_get_contents($image_url);
    $filename = basename($image_url);
    if(wp_mkdir_p($upload_dir['path']))
      $file = $upload_dir['path'] . '/' . $filename;
    else
      $file = $upload_dir['basedir'] . '/' . $filename;
    file_put_contents($file, $image_data);

    $wp_filetype = wp_check_filetype($filename, null );
    $attachment = array(
        'post_mime_type' => $wp_filetype['type'],
        'post_title' => sanitize_file_name($filename),
        'post_content' => '',
        'post_status' => 'inherit'
    );
    $attach_id = wp_insert_attachment( $attachment, $file, $post_id );
    require_once(ABSPATH . 'wp-admin/includes/image.php');
    $attach_data = wp_generate_attachment_metadata( $attach_id, $file );
    $res1= wp_update_attachment_metadata( $attach_id, $attach_data );
    $res2= set_post_thumbnail( $post_id, $attach_id );
}

http://codex.wordpress.org/Function_Reference/wp_upload_dir

http://codex.wordpress.org/Function_Reference/wp_insert_attachment

EDITAR: creación de ruta agregada

http://codex.wordpress.org/Function_Reference/wp_mkdir_p

Intenta usarlo set_post_thumbnail().

Editar por Otto: Usted aclaró su pregunta, así que aclararé la respuesta que dio Chip.

Básicamente, también debes hacer el 'archivo adjunto' para la publicación. Cuando se carga una imagen en la biblioteca de medios de WordPress, se realiza una entrada de publicación especial con un tipo de archivo adjunto. Este archivo adjunto está vinculado a alguna publicación específica a través del identificador post_parent.

Entonces, si conoce la ID del archivo adjunto, llame a set_post_thumbnail con el objeto de publicación o ID y la ID del archivo adjunto simplemente establecerá el indicador de miniatura de la publicación.

Si aún no ha creado el archivo adjunto, deberá hacerlo primero. La forma más fácil de hacerlo es con wp_insert_attachment(). Esta función toma una matriz de algunos parámetros, el nombre de archivo (el archivo ya debe estar en el directorio de carga adecuado) y la ID de la publicación principal a la que desea adjuntar el archivo adjunto.

Simplemente cargar un archivo y adjuntarlo a una publicación no hace nada automáticamente. Esto es simplemente una especie de mecanismo de categorización. El mecanismo de la galería, por ejemplo, usa las imágenes adjuntas de una publicación para construir la [galería] para esa publicación. Una miniatura para una publicación es solo una de las imágenes adjuntas que se ha configurado para ser la miniatura.

Puede encontrar más información sobre cómo usar wp_insert_attachment en el códice (vinculado anteriormente).

Me gustaría mejorar la respuesta de Robs utilizando las funciones principales de WP download_urlymedia_handle_sideload

<?php
/**
* Downloads an image from the specified URL and attaches it to a post as a post thumbnail.
*
* @param string $file    The URL of the image to download.
* @param int    $post_id The post ID the post thumbnail is to be associated with.
* @param string $desc    Optional. Description of the image.
* @return string|WP_Error Attachment ID, WP_Error object otherwise.
*/
function Generate_Featured_Image( $file, $post_id, $desc ){
    // Set variables for storage, fix file filename for query strings.
    preg_match( '/[^\?]+\.(jpe?g|jpe|gif|png)\b/i', $file, $matches );
    if ( ! $matches ) {
         return new WP_Error( 'image_sideload_failed', __( 'Invalid image URL' ) );
    }

    $file_array = array();
    $file_array['name'] = basename( $matches[0] );

    // Download file to temp location.
    $file_array['tmp_name'] = download_url( $file );

    // If error storing temporarily, return the error.
    if ( is_wp_error( $file_array['tmp_name'] ) ) {
        return $file_array['tmp_name'];
    }

    // Do the validation and storage stuff.
    $id = media_handle_sideload( $file_array, $post_id, $desc );

    // If error storing permanently, unlink.
    if ( is_wp_error( $id ) ) {
        @unlink( $file_array['tmp_name'] );
        return $id;
    }
    return set_post_thumbnail( $post_id, $id );

}

set_post_thumbnail() Es la mejor función para este requisito.

Creo que encuentras la identificación de un archivo adjunto a través de get_children()o get_posts(). El resultado tiene una matriz y dentro de esta matriz está la ID. El siguiente ejemplo para probar; espero que funcione; escribir sin pruebas, solo desde cero.

Para su requerimiento es importante que cambie get_the_ID()con su post-ID; devuelva la identificación del archivo adjunto y esto puede usar para foth set_post_thumbnail().

$attachments = get_children( 
    array(
        'post_parent' => get_the_ID(), 
        'post_type' => 'attachment', 
        'post_mime_type' => 'image'
    )
);
foreach ( $attachments as $attachment_id => $attachment ) {
    echo wp_get_attachment_image($attachment_id);
}

Acabo de encontrar esto y lo hice mucho más simple, funciona pero no soy un depurador de seguridad

if(!empty($_FILES)){
    require_once( ABSPATH . 'wp-admin/includes/post.php' );
    require_once( ABSPATH . 'wp-admin/includes/image.php' );
    require_once( ABSPATH . 'wp-admin/includes/file.php' );
    require_once( ABSPATH . 'wp-admin/includes/media.php' );

    $post_ID = "your post id!";

    $attachment_id = media_handle_upload( 'file', $post_ID );
    set_post_thumbnail( $post_ID, $attachment_id );
}

simple o que? Después de obtener los archivos correctos, WordPress manejará los medios y los cargará, luego los configurará como una miniatura.