WordPress Cómo: Desarrollar un archivo Comments.php

Artículo escrito por:
  • WordPress
  • Actualizado: Ago 12, 2013

Lecciones esenciales en el desarrollo de un archivo Comments.php con WordPress

Página de WordPress

Un sitio web de WordPress exitoso es uno que fomenta la interacción entre sus lectores y los productores de contenido mediante un "bien elaborado"comments.php" expediente. Esta interacción no solo es la clave para el éxito propio y perpetuo de un sitio web, sino que las interacciones comunes de los usuarios ayudan a comunicar la actividad y la autoridad del sitio web a los motores de búsqueda que clasifican específicamente los sitios web según la apreciación de los visitantes por el contenido que encuentran allí.

Por esta razón, dominar la plantilla "comments.php" dentro de cualquier tema de WordPress es absolutamente una parte esencial de la creación y promoción de un blog, revista o sitio web de aficionados exitoso. Muchos de los usuarios principiantes de WordPress se sienten intimidados por este y otros archivos de plantilla PHP, especialmente porque el usuario promedio de WordPress generalmente descarga temas y evita realizar modificaciones importantes en su apariencia o funcionalidad.

Sin embargo, esas modificaciones son realmente fáciles de hacer una vez que el usuario ha aprendido los conceptos básicos de las variables XHTML, CSS, PHP, WordPress y las formas comunes de generar contenido del sitio, datos del usuario y fomentar la comunicación entre todos los que visitan el sitio. Todo comienza con un cliente FTP, un editor de texto y el deseo de aprender nuevas formas de expresar ideas antiguas en un código puro y aceptable.

Paso 1: Cómo encontrar el archivo de plantilla Comentarios.php en el servidor del sitio web

Encontrando los comentarios.php

Para aquellos nuevos en la personalización de plantillas de WordPress, puede ser un poco difícil localizar exactamente dónde se almacenan los archivos que necesitan ser modificados. La mayoría de las veces, WordPress se instala en el directorio raíz de un servidor, lo que permite acceder a él como la página de índice del sitio. En este caso, los archivos de un tema (incluida la plantilla "comments.php") se pueden encontrar navegando a la siguiente ruta utilizando un cliente FTP o un administrador de archivos basado en la web dentro del panel de control del sitio:

/ public_html / wp-content / themes / your-selected-theme-folder /

Dentro de esta carpeta, aparecerá una extensa lista de archivos PHP, con nombres como "single.php" y "style.css", entre otros. El archivo que se va a editar es, obviamente, llamado "comments.php". Ese archivo se puede abrir con el editor de texto incorporado del cliente FTP, o se puede editar con un programa de edición de texto separado como el Bloc de notas en Windows o TextEditor para Usuarios de Mac OS X.

Es probable que este archivo no esté en blanco, y probablemente ya se haya creado una plantilla completa dentro del archivo. Lo que seguirá en los siguientes pasos es una guía para cada una de las variables ubicadas dentro del archivo y cómo usarlas para revisar el diseño actual o crear una plantilla completamente nueva que se adapte mejor a las necesidades de los productores y comentadores de contenido del sitio web.

Paso 2: Aprendiendo cómo prevenir el acceso al archivo Comments.php

Comentarios.php en WordPress

La mayoría de las plantillas almacenadas dentro de un tema son accesibles directamente por los usuarios y pueden mostrar el contenido del sitio, como páginas, publicaciones, categorías, archivos y comentarios, de forma dinámica. Sin embargo, los usuarios no pueden acceder directamente a algunas plantillas y, si los usuarios pudieran acceder a ellas, sería posible ejecutar ataques maliciosos en los usuarios, el contenido e incluso la base de datos de un sitio. El archivo "comments.php" es una plantilla a la que absolutamente deben acceder directamente los usuarios de un sitio, ya sea accidental o intencionalmente. WordPress emplea una simple declaración de PHP para garantizar que se acceda al archivo solo cuando se incluye en otro documento.

Se parece a esto:

<? php if (! empty ($ _ SERVER ['SCRIPT_FILENAME']) && 'comments.php' == basename ($ _ SERVER ['SCRIPT_FILENAME'))):? >

<? php die ('Whoa! Esta página no se puede ver de forma independiente. Si desea publicar un comentario, vaya a la entrada que desea comentar y utilice el formulario incluido en la página. ¡Disculpe las molestias!') ; ? >

<? php endif; ? >

<? php if (! empty ($ post-> post_password)):? > <? php if ($ _ COOKIE ['wp-postpass_'. COOKIEHASH]! = $ post-> post_password):? >

<? php endif; ? >

<? php endif; ? >

El código anterior identifica si la plantilla se está viendo actualmente como un archivo PHP "incluido" y, si no, imprime un mensaje de error útil para los visitantes del sitio. Esto asegura que no ocurra ninguna actividad maliciosa detrás de las escenas. También realmente, realmente molestará a los hackers que esperaban encontrar una manera fácil de comprometer la integridad del sitio. La segunda línea asegura que una entrada realmente se puede mostrar; si está protegido por una contraseña, la entrada no se mostrará y tampoco la plantilla "comments.php". Sin esta línea de código en la parte superior del archivo, los visitantes pueden comentar fácilmente sobre una entrada cuyo contenido no se les permitió leer.

Debe tenerse en cuenta que, si esta serie de etiquetas no está presente en el archivo "comments.php" actual del tema, debe agregarse de inmediato y el archivo debe guardarse en el servidor antes de continuar. Nunca es demasiado pronto para arreglar una vulnerabilidad de seguridad potencial.

Paso 3: reconocer el bucle de comentarios y agregar variables para personalizar su apariencia

Dependiendo de la experiencia que tenga alguien con las variables de WordPress y su inserción en las plantillas, pueden o no estar familiarizados con el uso de "bucles" en estos archivos al insertar variables y extraer información de usuarios o publicaciones de la base de datos. Tanto las entradas como los comentarios tienen sus propios formatos de bucles de WordPress, y esa es la siguiente serie de declaraciones de PHP que aparecerán en el archivo "comments.php". Dentro de este bucle, se construye la plantilla de comentario real. Esto determina el aspecto de cada comentario individual para el usuario final después de que se haya publicado, y es una mezcla de XHTML, CSS y PHP.

Los elementos CSS y XHTML de esta plantilla ya deben ser conocidos por el usuario emprendedor de WordPress que está aprendiendo a personalizar las plantillas, ya que son un aspecto esencial tanto de la apariencia del sitio como de su contenido tal como está escrito en el Tablero de WordPress. Trabajando con el supuesto de que XHTML y CSS son cantidades conocidas, esto es lo que un usuario necesitará saber sobre las variables de WordPress y PHP al editar o construir una plantilla de comentarios.

Cada variable dentro del bucle de comentarios se construye como una declaración PHP separada como la que aparece a continuación:

<? php get_variable? >

Dentro de la propia plantilla "comments.php", cada variable disponible para su uso comienza con el prefijo "comment_". El anuncio se coloca entre la apertura y el cierre de las etiquetas PHP, como se demostró anteriormente. Hay varias variables que se pueden usar dentro de esta plantilla para extraer información de la base de datos.

<? php comment_author (); ? > Extrae el nombre del autor de la base de datos y lo imprime exactamente como lo escribió, donde sea que se coloque la variable. Por lo general, esto se debe usar como parte de la construcción de un enlace para enviar a los usuarios al sitio web del autor o a su dirección de correo electrónico.

<? php comment_date (); ? > Imprime la fecha en que se publicó un comentario; de forma predeterminada, esta variable utiliza el formato de fecha como se define en la configuración de WordPress dentro del panel de administración de Dashboard. Para personalizar el aspecto de la fecha en los comentarios, los usuarios pueden insertar variables de código de fecha de PHP (como F jS Y) entre paréntesis.

<? php comment_ID (); ? > La identificación numérica del comentario en sí, generalmente en orden cronológico. Esto se puede usar para rastrear un enlace permanente de comentarios para enlazar directamente a un solo comentario.

<? php comment_author_link (); ? > Esta variable es una especie de construcción "todo en uno" para el autor del comentario, ya que imprime su nombre y se vincula automáticamente a cualquier sitio web o dirección de correo electrónico que se ingresó durante el proceso de envío de comentarios.

<? php comment_text (); ? > Imprime el comentario real, rodeado de útiles etiquetas que se pueden personalizar utilizando el código de estilo CSS dentro del archivo de la hoja de estilo "style.css" del tema.

<? php comment_time (); ? > Al igual que la variable de fecha, esto imprime la hora y el minuto exactos en que se publicó un comentario y utiliza el formato establecido en el Panel de WordPress de forma predeterminada. También se puede personalizar colocando las variables de fecha de PHP dentro de los paréntesis.

<? php comment_type (); ? > Esta variable diferencia entre comentarios tradicionales, publicaciones de trackback y pingbacks de sitios web. Esto es útil para ordenar las interacciones y mostrarlas por separado en la plantilla de comentarios.

Paso 4: dominar el arte del formulario de comentarios

El siguiente segmento de la plantilla "comments.php" es el formulario de envío de comentarios que permite la interacción en la que confían la mayoría de los sitios web. Este formulario puede producirse utilizando elementos de "formulario" XHTML estándar, y es probable que ya esté construido en la plantilla existente. Los elementos del formulario deben tener ciertos nombres (nombre, correo electrónico, url, comentario) pero, más allá de eso, depende completamente del usuario darles identificadores, clases y pautas de estilo.

El único elemento que debe incluirse siempre que se diseñe un formulario de comentarios y se coloque en la plantilla es una variable condicional que solo muestra el formulario cuando los comentarios están "abiertos". Recuerde que WordPress permite que los comentarios se "cierren" dentro del Tablero en cualquier Entrada, en cualquier momento. También se puede deshabilitar todo el sitio de comentarios de capacidad. Y, por supuesto, los comentarios se "agotan" y se "cierran" automáticamente después de los días de 30-90 desde el momento en que se publicó una publicación. Esta variable condicional se coloca antes de la etiqueta XHTML "formulario" de apertura y se ve exactamente así:

<? php if (comments_open ()):? >

Después de que el formulario de comentarios se haya insertado completamente, con los cuatro elementos de "formulario", un botón de envío y un botón de reinicio, la declaración condicional de PHP debe cerrarse. De lo contrario, toda la página se cortará inmediatamente después de cualquier comentario si se revoca la capacidad de comentar una publicación. Las declaraciones de cierre para esta declaración PHP condicional se parecen al ejemplo a continuación:

<? php else:? >
<? php endif; ? >

Con eso, el formulario de comentarios está en gran parte completo. Recuerde que cada elemento del formulario debe tener un nombre de acuerdo con la lista anterior, o la información no se enviará correctamente a la base de datos de WordPress. Esto dará como resultado una larga lista de comentarios vacíos, ya que los datos se perderán completamente y no se almacenarán en ningún lugar. Esto también llevará a lectores enojados que sienten que su voz no ha sido escuchada, y ningún administrador del sitio quiere tener ese tipo de problema en su conciencia.

Paso 5: aportando algo de personalidad al proceso

Hace varios años, WordPress adquirió una pequeña empresa conocida como Gravatar; esa compañía era conocida por mostrar imágenes de usuarios universales que estaban vinculadas a una dirección de correo electrónico específica. Esas imágenes podrían mostrarse en los comentarios de entrada en varios sitios web, utilizando múltiples plataformas de administración de contenido, siempre y cuando la estructura de URL de imagen estándar se incluyera en la plantilla.

Desde la adquisición de la compañía hace algún tiempo, WordPress ha integrado esta funcionalidad directamente en el Tablero de WordPress y en el archivo de la plantilla "comments.php". Es una excelente manera de personalizar la experiencia de interacción del usuario al permitir que cada usuario establezca una imagen personalizada que los identifique a los demás comentaristas y administradores de sitios web.

Gravatar

En primer lugar, esta función debe estar habilitada en el Panel de WordPress. Vaya al encabezado de la barra lateral "Configuración" y haga clic en el enlace al panel de administración "Lectura". Aquí, puede configurar cosas como la "calificación" máxima que se mostrará en las imágenes de Gravatar, así como la imagen predeterminada y qué hacer con los usuarios que no tienen una imagen de Gravatar definida. Cuando se hayan perfeccionado estos ajustes, guarde la página y regrese a la plantilla "comments.php" que se editó anteriormente. Se puede colocar una variable simple dentro del bucle de comentarios que mostrará la imagen predeterminada, un avatar de usuario generado dinámicamente o el Gravatar real que el usuario ha establecido para sí mismo.

La variable que muestra todas estas imágenes está abajo:

<? php echo get_avatar (); ? >

Para obtener más información sobre cómo agregar gravatar en su sitio de WordPress, lea también: Trayendo el Gravatar en temas y comentarios de WordPress.

Es un poco diferente de las variables estándar utilizadas en el bucle de comentarios, pero funciona igual de bien. Se puede personalizar con modificadores dentro de los paréntesis que determinan la imagen predeterminada para los comentaristas que no son de Gravatar, así como el tamaño de la imagen que se imprimirá dentro de los comentarios. Con eso, el típico archivo "comments.php" se ha dominado y aprendido. Ahora es el momento de profundizar en los diseños personalizados, las nuevas formas de mostrar las interacciones del usuario y las formas innovadoras de incluir el formulario estándar de envío de comentarios.

Verifique siempre los errores y valide los estándares de diseño

Finalmente, asegúrese de verificar siempre las modificaciones de la plantilla para asegurarse de que funcionen tan bien como se planificó. Al igual que con cualquier solución de software basada en PHP y MySQL, algunas ediciones o percances accidentales de codificación causarán que se impriman grandes errores en la página estática de la entrada, y los usuarios no podrán usar las funciones de comentarios presentes en la plantilla. Con la validación de XHTML y CSS, la cuidadosa atención a los detalles y el uso adecuado de las variables de WordPress, esta complicación se puede evitar en gran medida.

Cuando la página ha dejado de producir errores y muestra exactamente cómo se pretende, el proceso se completa. Ahora es el momento de mostrar el trabajo a sus usuarios y animarlos a que visiten el sitio web de Gravatar, se registren y personalicen su apariencia en los comentarios. Recuerde que la nueva plantilla de comentarios es tan buena como los usuarios lo hacen posible, así que asegúrese de explicar las nuevas características o requisitos que se hayan desarrollado a lo largo del camino.

Y con eso, tu trabajo está terminado!

Acerca de Jerry Low

Fundador de WebHostingSecretRevealed.net (WHSR): una revisión de alojamiento confiable y utilizada por los usuarios de 100,000. Más de 15 años de experiencia en alojamiento web, marketing de afiliación y SEO. Colaborador de ProBlogger.net, Business.com, SocialMediaToday.com y más.