Word Press Kurosaki 2014

download Word Press Kurosaki 2014

of 27

  • date post

    31-Dec-2015
  • Category

    Documents

  • view

    35
  • download

    3

Embed Size (px)

Transcript of Word Press Kurosaki 2014

  • Bienvenido al manual de wordpress 2014

    Antes de continuar Este manual ha sido creado de manera personal y para su uso personal como manual

    de referencias. Este contiene trminos redactados con lenguaje personal y no profesional. As que, pueden

    existir trminos mal redactados o clausulas errneas.

    La estructura bsica de una plantilla de wordpress, est compuesta por cuatro archivos

    que son indispensables:

    header.php

    index.php

    sidebar.php

    footer.php

    HEADER

    CONTENT (INDEX)

    FOOTER

  • HEADER.PHP (Funciones que encontraras dentro del archivo header.php):

    language_attributes()

    Muestra atributos HTML acerca del idioma/regin como la direccin del texto y el

    lenguaje que la constituyen (por ejemplo: lang=es-ES, dir=ltr).

    Se encuentra en: wp-includes/general-template.php

    Ejemplo:

  • Ejemplo II:

    wp_title(

  • stylesheet_url [ funcin: get_stylesheet_uri() ]

    stylesheet_directory [ funcin: get_stylesheet_directory_uri() ]

    template_url

    template_directory [ funciones: get_theme_root(), get_template(),

    ssssssssssssssss get_bloginfo(template_url), get_template_directory_uri() ]

    pingback_url

    atom_url

    rdf_url

    rss_url

    rss2_url

    comments_atom_url

    comments_rss2_url

    siteurl (parmetro obsoleto, use funciones) [ funcin: home_url(), bloginfo(url) ]

    home (parmetro obsoleto, use funciones) [ funcin: home_url(), bloginfo(url) ]

    HTML:

    Regularmente va en las etiquetas , , y otros elementos de la cabecera.

    is_home() / is_front_page()

    Esta funcin checa si se muestra la pagina principal, no admite parmetros y devolver

    true o false, segn se cumpla la condicin. Tambin puedes ver is_front_page(), esta al

    igual que is_home() devolver true, la ventaja de is_fron_page(), tambin aplica cuando

    en Ajustes Lectura, tienes seleccionado Ultimas entradas (post), o igual, si tienes

    seleccionado pagina estatica y una pagina principal.

    Se encuentra en: wp-includes/query.php

    Ejemplo:

    HTML:

    Se encuentra dentro del dentro de una condicional para mostrar la

    descripcin del blog en el titulo , o no.

  • is_singular()

    Es una etiqueta condicional que checa si se est mostrando una entrada en singular, como

    seria, si se muestra una entrada (post), una pagina, o una pagina de archivos adjuntos,

    como lo son estas funciones: is_single(), is_attachment() or is_page(), esto devolver un

    bolneado, (true), si se cumple al menos una funcin de las ya mencionadas.

    Si se especificara un parmetro, la consulta checar si alguno de los parmetros se

    cumple.

    Se encuentra: wp-includes/query.php

    Ejemplo:

    Mostrar un anuncio en la pagina de contacto que de titulo le hemos puesto Contact. if(is_singular(contact)) {

    // code for show a adv 1

    }

    Ejemplo II.

    Mostrar una imagen solamente en todas las entradas (post), en las paginas no. if(is_singular(post)) { //otros valores: page, attachment, revision, nav_menu_item

    }

    HTML:

    No tiene posicin alguna, en el header.php lo encontraremos al final de

    get_option()

    Una forma segura de obtener los valores del parmetro que deseemos.

    Los valores para el parmetro son los nombres de los campos de la tabla wp_options

    dentro de nuestra BD, como por ejemplo: admin_email.

    Se encuentra en: wp-includes/option.php

  • Parametros:

    Los posibles valores para $parametro son los nombres de los campos de la tabla

    wp_options, por ejemplo:

    admin_email, blog_charset, blogdescription, siteurl, blogname, start_of_week, etc.

    HTML:

    No tiene ubicacin especfica dentro de la estructura.

    wp_enqueue_script()

    Vincula los scripts previamente registrados a la pagina generada en el momento (pagina

    actual). Si su script an no ha sido vinculado, usted puede agregarlo mediante un

    manejador, usando la funcin wp_register_script.

    Se encuentra en: wp-includes/functions.wp-scripts.php

    valor por defecto, ninguno.

    Parametros:

    wp_enqueue_script($parametro1, $parametro2, $paramet3, $paramet4, $paramet5);

    $parametro1: (obligatorio)(Tipo: cadena de texto) Nombre utilizado como

    manipulador del script.

    $parametro2: (opcional) (Tipo: cadena de texto) URL del script, puede utilizar la

    funcin plugins_url() para obtener las URLs en local par scripts y

    get_template_directory_uri() para temas.

    $paramet3: (opcional) (Tipo: Array) Array de todos los manipuladores del cual

    depende el scripts antes de ser cargado. Si el scripts no tiene dependencias, arrojara

    falso. Este parmetro solo es necesario cuando no se ha registrado el script con la

    funcin wp_register_script().

    $paramet4: (opcional) (Tipo: cadena de texto) versin del scripts, si no se especifica,

    wordpress automticamente aadir por defecto la versin de wordpress sobre el que

    se trabaja.

    $paramet5: (opcional) (Tipo: boleano) Si se especifica true, el scripts se colocara

    antes del cierre del elemento body, es decir, antes de , y para ello es

    necesario que el tema tenga una etiqueta de pie , usando la funcin wp_footer(),

    que est dentro del archivo wp-contents/themes/NOMBRE-TEMA/footer.php

  • Los scripts registrados por wordpress, puede encontrarlos en:

    wp-includes/script-loader.php

    NOTA:

    Para ver la lista de todos los scripts registrados por default de wordpress puede visitar

    este link:

    http://codex.wordpress.org/Function_Reference/wp_enqueue_script#Default_Scripts_Inc

    luded_and_Registered_by_WordPress

    Ejemplo I:

    wp_enqueue_script(comment-reply); //Solamente especificamos el parmetro obligatorio.

    Ejemplo II:

    Agregar el scripts de jQuery desde la URL de la api de google. //paso 1, registramos el nombre del manipulador del script.

    wp_register_script(jqueryapi, http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js);

    //paso 2, lo llamamos si estamos en una pagina.

    if(is_page()) :

    wp_enqueue_script(jqueryapi);

    endif;

    Ejemplo III:

    Agregar el scripts de un slider que dependa del scripts jquery de google. //primero lo registramos

    wp_register_script(micarousel, get_template_directory_uri().js/micarousel.js, jqueyapi);

    //lo mandamos a llamar con la funcin wp_enqueue_script, y si no se carga el script de jqueryapi, entonces

    //este script tampoco se cargara y evitaremos una PETICION tonta.

    wp_enqueue_script(micarousel,);

  • Ejemplo IV:

    Agregar un script que dependa de jqueryapi sin usar wp_register_script.

    wp_enqueue_script(miscript

    get_template_directory_uri().js/miscript.js

    jqueryapi);

    NOTA:

    Los ejemplos no son 100% completos, a partir de esta pgina no recomiendo llevarlo a la

    prctica, an falta entender otras funciones como wp_enqueue_scripts() y add_action().

    HTML:

    No tiene lugar especifico, dentro del archivo header.php, lo encontraremos realizando la

    funcin de agregar un script para activar los comentarios aninados, se encuenta a final del

    elemento head .

    wp_head()

    Esta funcin se activa dentro y al final del , de la plantilla, y su principal

    accin es activar las funciones requeridas en el momento, para asi evitar cargar funciones

    que no se necesitaran y ahorrar peticiones al servidor.

    Se encuentra en: wp-includes/general-template.php

    Ejemplo:

    Creando una funcin y activarla //paso 1, creamos una funcion

    function sendMail($post_ID) {

    mail(mail@example.com, the mail asunt, the content);

    return $post_ID;

    }

    //paso 2, agregamos en wp_head la funcin que hemos creado (sendMail).

  • //paso 3, en el , mandamos a llamar las funciones (incluida la que hemos creado).

    HTML:

    Se ubica al final de las etiquetas

    body_class()

    Esta funcin proporciona al elemento diferentes clases, que nos sern tiles a la

    hora de agregar estilos.

    Se encuentra en: wp-includes/post-template.php

    Su valor por default es null, (no tiene valores adicionales, solo los actuales).

    Ejemplo I:

    >

    $miarray = array(myclass, claseParaTexto, claseFocus, claseHover);

  • HTML:

    Se encuentra en header.php dentro de la etiqueta de apertura .

    ANTES DE SEGUIR

    Hablemos de las clases para nuestros estilos CSS.

    Podemos omitir la funcin body_class() y crear nuestros estilos 100% personalizados, pero

    ya tenemos tarea ahorrada, aqu las clases que existen dentro de las plantillas:

    Pagina de Inicio

    Pagina Principal: home

    Si la pagina principal muestra las entradas del blog: home, blog.

    Si la pagina principal muestra una pagina estatica: home, page.

    Entradas de Inicio

    Entradas del blog: blog

    Si las entradas del blog se muestran sobre la pagina de inicio: home, blog

    Si las entradas del blog se muestran sobre una pagina estatica: page, blog

    Entrada/Post

    Pagina de entrada: single, postid-{ID}

    Pagina de una entrada: single-post

    Pagina de una entrada personalizada/tipo: single-{posttype}

    *Formatos de entradas (Si soporta):

    Entrada con formato asignado: single-format-{format}

    Entrada con formato no asignado: single-format-standard

  • Pagina Fija: attachment, single-attachment, attachmentid-{ID