En el último post vimos cómo dar permisos a nuestros usuarios colaboradores para cargar archivos a la Biblioteca de Medios y poder usarlos en sus entradas. Llegados a este punto, puede que nos interese hacer que nuestros colaboradores sólo puedan ver sus propios archivos y los de nadie más.

Esto como siempre podemos implementarlo mediante código en el archivo functions.php o también mediante un sencillo plugin. Vamos a ver ambos métodos, pues cada uno tiene sus ventajas e inconvenientes.

Por un lado, usar código nos obliga a estar al tanto del Códex de WordPress por si en una futura actualización se modifica alguna función, hook o metodología, que haga errar nuestro código. En cambio ganaremos en optimización, pues los plugins que instalamos siempre incluyen archivos, funciones y código que no necesitamos.

El código:

<?php
//Limitar el acceso a la librería solo a tus propios archivos
 function mostrar_solamente_archivos_del_usuario($query){
    $user_id = get_current_user_id();

    if($user_id && !current_user_can('activate_plugins') && !current_user_can('edit_others_posts')){
        $query['author'] = $user_id;
    }
    return $query;
} 
add_filter('ajax_query_attachments_args', 'mostrar_solamente_archivos_del_usuario');
?>

Si optamos por usar el plugin, conviene asegurarnos de que su autor lo actualiza con frecuencia para mantener la compatibilidad con las nuevas versiones de WordPress.

En este caso vamos a usar WP Users Media, que en el momento de escribir este artículo, hace unas 3 semanas que se actualizó, lo cual indica que su autor lo está manteniendo.

Su configuración es muy simple, y una vez instalado y activado nos dirigimos al menú Ajustes – WP Users Media y solo tenemos que marcar los roles a los que aplicar la restricción de ver únicamente sus archivos en la biblioteca de medios:

Si también queremos ampliar esta limitación al administrador (por si existen varios administradores en el sitio web), podemos marcar la opción:

Y eso es todo de momento. Espero que esta nueva serie de Posts ayuden a aquellos que como yo, necesitaban habilitar zonas especiales para que otros usuarios puedan añadir contenido al sitio web.

Un saludo y hasta el próximo post!

Si hemos creado un formulario externo para que usuarios colaboradores puedan enviar contenidos al sitio web sin necesidad de acceder al Dashboard, veremos que al cargar el editor de WordPress (wp_editor), no aparece el botón de Añadir Objeto para acceder a la Biblioteca de Medios:

Sería muy interesante (y nos ahorraría mucho trabajo), que nuestros usuarios colaboradores pudieran subir imágenes y contenidos para ilustrar sus contenidos, evitando tener que hacerlo nosotros a la hora de revisar la entrada.

Para ello tendremos que darle al usuario colaborador (contributor) permisos o capacidad para añadir archivos a WordPress. Por internet he encontrado en numerosos posts el siguiente código:

if ( current_user_can('contributor') && !current_user_can('upload_files') )
    add_action('admin_init', 'allow_contributor_uploads');
function allow_contributor_uploads() {
    $contributor = get_role('contributor');
    $contributor->add_cap('upload_files');
}

Pero este código NO FUNCIONA en versiones recientes de WordPress. Aparecerá el botón de Añadir Objeto, pero en el momento que intentes cargar un archivo, te dirá que no tienes permisos para añadir archivos a esta entrada.

Y tiene que ver con la forma en la que ahora WordPress trata a los archivos de medios, dándoles las características cómo de un custom post o estilo de entrada. Para que funcione tienes que dotar al usuario colaborador de otros permisos adicionales como, editar páginas publicadas, editar otras páginas, editar entradas publicadas y editar otras entradas, además por supuesto, de subir archivos:

//Permitir al colaborador subir imágenes
    function update_caps() {
 $role = get_role( 'contributor' );
 $caps_to_add = array(
 'edit_others_posts',
 'edit_published_posts',
 'edit_others_pages',
 'edit_published_pages',
 'upload_files'
 );
 foreach( $caps_to_add as $cap )
 $role->add_cap( $cap );
 }
  add_action('init', 'update_caps');

Con este código si he conseguido que un usuario colaborador pueda cargar imágenes desde un formulario externo en el Frontend de WordPress.

ACTUALIZACIÓN DESDE WORDPRESS 5.0

En versiones recientes de WordPress (desde la 5), no he necesitado añadir permisos de edit_others_posts, edit_others_pages, edit_published_posts y edit_published_pages. Simplemente agregando la capacidad «upload_files», ha funcionado.

En el siguiente post veremos cómo hacer que un usuario colaborador solo pueda ver sus archivos en la Biblioteca de Medios.

Ya que vamos a tener una página o sección exclusiva para colaboradores, lo lógico sería que sólo este tipo de rol tuviera acceso a esta página.

Usaremos este pequeño script situado al principio de nuestra página o template (ver post cómo crear un formulario externo para colaboradores) page-colaboradores.php:

<?php 
 $user = wp_get_current_user();
 
 if(!empty($user) && !in_array("contributor", (array) $user->roles)){ ?>
 <script>
 alert('Esta zona es solo para colaboradores. Por favor, inicia sesión para acceder.');
 location.href='http://www.mi-sitio.com/';
 </script>"
<?php } ?>

Lo primero que hacemos es recoger (wp_get_current_user) las propiedades o características del usuario en cuestión y comprobamos si este tiene asignado el rol de colaborador (contributor).

De no ser así, redirigiremos mediante un simple script a la página principal del sitio web.

Este script serviría igualmente para comprobar cualquier otro rol, administrador (admin), autor (author), editor (editor), suscriptor (suscriber)…solo tenemos que cambiarlo en el if.

Si tenemos varias páginas exclusivas para un rol determinado, podríamos pegar este script en un archivo aparte (redigirir.php), y llamarlo al principio de cada una de las páginas o templates que solo sean accesibles a ese rol determinado:

<?php include('redirigir.php'); ?>

Si deseamos tener una zona personalizada para usuarios colaboradores de nuestro sitio web, seguramente no queramos que tengan acceso al panel de control o Dashboard de WordPress aunque este esté limitado por el rol establecido (suscriptor, colaborador, autor…).

Queremos tener un sitio web homogéneo y que nuestros usuarios no abandonen el Frontend para añadir sus contenidos.

Ya vimos en el anterior post, cómo ocultar la barra de admin a usuarios no administradores, pero todavía seguirían teniendo acceso si teclean directamente la URL del Dashboard (http://www.tudominio/wp-admin).

Añadiendo este código al archivo functions.php de nuestro theme principal, impediremos que, aún tecleando la URL, se pueda acceder al Dashboard de WordPress si no eres usuario Administrador:

//Restringir panel admin solo a administradores
function restrict_admin_area_by_rol(){
  if (!current_user_can('manage_options') && (!defined('DOING_AJAX') || ! DOING_AJAX )){
    wp_redirect(site_url());
    exit;
  }
}
add_action('admin_init', 'restrict_admin_area_by_rol', 1);

Como vemos en el código, definimos que si el usuario en curso (current user) no posee opciones administrativas (! es igual a NOT, o negación), será redirigido a la página principal del sitio web.

Debemos tener en cuenta que esta función impide que el usuario conecte con cualquier archivo dentro del directorio wp-admin, pero a veces es necesario acceder a estos archivos desde el front-end, por ejemplo, para peticiones AJAX, ya que el archivo que carga las funciones AJAX en WordPress (admin-ajax.php) se encuentra precisamente dentro de /wp-admin. Para ello añadimos la siguiente condición && (!defined(‘DOING_AJAX’) || ! DOING_AJAX )), para excluirla de la redirección.

En el siguiente Post veremos cómo permitir el acceso a una página según el rol del usuario.

Continuando con el anterior post «Crear entradas desde un formulario externo en WordPress«, vamos a mejorar nuestro formulario para colaboradores ocultando la barra de administración de WordPress a todo usuario que no sea administrador del sitio:

Para ello solo tenemos que incluir este código en el archivo functions.php de nuestro theme principal. Podemos incluirlo al final del todo si queremos, para tenerlo mejor localizado:

// Ocultar barra de admin a usuarios no administradores
function ocultar_admin_bar(){
   if(current_user_can('administrator')){
      show_admin_bar(true);
   }else{
       show_admin_bar(false);
   }
}
add_action('after_setup_theme','ocultar_admin_bar');

No tiene sentido que si estamos creando una zona personalizada para nuestros colaboradores evitando que toquen nada en el Dashboard, puedan tener acceso a él. Con este código conseguimos que no tengan un acceso directo al Dashboard, pero todavía podrían entrar si teclean la URL «/wp-admin».

En el siguiente post, veremos cómo impedir el acceso al Dashboard a usuarios que no sean administradores, redirigiéndolos a la página principal del sitio web.

Si necesitamos de colaboradores que aporten contenidos a nuestro blog, pero no queremos que tengan acceso al Dashboard (o panel de control) de WordPress, podemos facilitarles un formulario externo para que redacten el contenido y se envié pendiente de revisión.

Para ello vamos a crear un página interna donde insertaremos un formulario en HTML y el código PHP necesario para que el contenido se envíe y se cree la entrada en el blog.

¿Te atreves? comenzamos…

Paso 1. Crear una página interna «Formulario de colaboradores»

Como si de cualquier otra página se tratase, nos dirigimos al menú Páginas y añadimos una nueva llamada por ejemplo, Formulario de colaboradores:

Paso 2. Crear un nuevo archivo page-colaboradores.php

Lo primero, nos situaremos sobre el directorio de nuestro tema principal y crearemos un nuevo archivo al que llamaremos por ejemplo «page-colaboradores.php».

Este archivo lo vamos a utilizar como plantilla (o template) para nuestro formulario, así que lo primero que vamos a incluir en el archivo es el siguiente código:

<?php
/* Template Name: Formulario Colaboradores */
?>

Ahora volvemos a la página que creamos anteriormente, recargamos y en la sección Plantilla, seleccionamos el nuevo template que acabamos de crear «Formulario colaboradores»:

Paso 3. Copiar el contenido de page.php a page-colaboradores.php

Para no trabajar sobre una página en blanco, vamos a ir al archivo page.php de nuestro tema principal, copiamos todo el código y lo pegamos en nuestro page-colaboradores.php después del código insertado en el Paso 2.

Así trabajaremos sobre la estructura de nuestro tema principal (con su cabecera, menús, pié de página…) y nuestro formulario se integrará perfectamente con el diseño general.

Paso 4. Eliminar el Loop de WordPress

Este paso es opcional, pero podemos prescindir de código que no vamos a usar. El Loop de WordPress se encarga de obtener el contenido de la base de datos correspondiente a la página o entrada en la que nos encontremos. Como en este ejercicio no vamos a cargar ningún contenido de la base de datos, si no que insertaremos el formulario manualmente, podemos eliminar todo el código del Loop de WordPress.

Normalmente el Loop de WordPress comenzará con:

while(have_posts()) : the_post();

y termina con:

endwhile;

Paso 5. Crear el formulario en HTML (y algo de PHP)

Añadimos el código HTML para el formulario compuesto por un campo de texto para insertar el título de la entrada y el editor de WordPress para añadir el contenido, sin olvidar el botón submit para enviar el formulario.

<form name="contenidoColaboradores" id="contenidoColaboradores" method="post">
<p>
    <input type="text" name="tituloPost" placeholder="Escribe aquí el título de la entrada"/>
</p>

<p>
<?php
    wp_editor(
        $post_obj->post_content,
        'userpostcontent',
        array('textarea_name' => 'contenido')
    ); 
?>
</p>

<p>
    <input type="submit" value="Enviar Post"/>
</p>

<?php wp_nonce_field('contenidoColaboradores'); ?>
</form>

La función wp_nonce_field() añade seguridad al formulario, evitando que la información llegue desde un formulario ajeno al sitio web.

Nuestro formulario quedará de esta forma:

Paso 6. Procesar los datos del formulario y crear la entrada

$mi_entrada = array(
 'post_title' => wp_strip_all_tags($_POST['tituloPost']),
 'post_content' => $_POST['contenido'],
 'post_type' => 'post',
 'post_status' => 'pending',
 'post_author' => $user_id,
);
$nuevo_post = wp_insert_post($mi_entrada);

Por último, enviamos una entrada de prueba y esta quedará registrada como Pendiente de revisión:

Debemos tener en cuenta que cualquier persona que acceda a la URL del formulario, podrá enviarnos entradas. Ya depende de nosotros cómo gestionamos la página del formulario, si la restringimos únicamente a usuarios registrados, o con determinado rol, o impedimos el acceso por contraseña, etc.

Actualización para marcar la categoría seleccionada de la entrada.

Seleccionar la categoría o categorías de destino de la entrada es algo más complejo. Primero tendríamos que añadir al formulario la lista de categorías disponibles.

foreach (get_terms('category', array('hide_empty' => false,)) as $tag){ 
    echo "<input type='checkbox' name='" . $tag->slug . "' value='" . $tag->slug . "'/> 
    <label for='".$tag->slug."'>". $tag->name . "</label><br/>"; 
}

Eso debería cargar las categorías disponibles en checkboxs. Después guardar en un array las categorías que haya marcado el usuario para la entrada:

$categorias = array(); 

foreach(get_terms('category', array('hide_empty' => false,)) as $tag){ 
    $termino_taxonomia = $tag->slug; 
    if(isset($_POST[$termino_taxonomia])){ 
        $term.$termino_taxonomia = term_exists($termino_taxonomia, 'category', 0);   
        array_push($categorias, $term.$termino_taxonomia['term_taxonomy_id']); 
    } 
} 

$categorias_marcadas = array( 'category' => $categorias );

Y añadir las categorías marcadas a la Query:

$post = array( 
    'post_title' => "Lo que sea", 
    'post_content => $_POST['contenido'], 
    'tax_input' => $categorias_marcadas, 
    'post_status' => 'pending' 
);

Y crear el post:

$the_post = wp_insert_post($post);

Se que es algo complejo, pero hay que hacer todos esos pasos para que las categorías marcadas queden registradas en el post.

Espero que os haya resultado de utilidad y hasta el próximo post!