Estas en: Home > administración

Entradas etiquetadas con administración

Cron Job WordPress

WordPress 3.x para desarrolladores: Temas y plantillas, widgets.php

0

El siguiente archivo que vamos a crear es widgets.php que generará un widget para mostrar diferentes tipos de contenido, como citas estados, etc.

 

WIDGETS.PHP

Creamos el archivo inc/widgets.php y añadimos el siguiente código:

  1. <?php
  2.  
  3. /**
  4.  * Makes a custom Widget for displaying Aside, Link, Status, and Quote Posts available with New Theme
  5.  *
  6.  * Learn more: http://codex.wordpress.org/Widgets_API#Developing_Widgets
  7.  *
  8.  * @package WordPress
  9.  * @subpackage Nwe_Theme
  10.  */
  11. class New_Theme_Ephemera_Widget extends WP_Widget {
  12.  
  13. }

Creamos la clase New_Theme_Ephemera_Widget que nos permitirá crear el widget.

Dentro de la clase añadimos los siguientes métodos.

  1. <?php
  2.  
  3. /**
  4. * Constructor
  5. *
  6. * @return void
  7. **/
  8. function New_Theme_Ephemera_Widget() {
  9. $widget_ops = array( 'classname' => 'widget_newtheme_ephemera', 'description' => __( 'Use this widget to list your recent Aside, Status, Quote, and Link posts', 'newtheme' ) );
  10. $this->WP_Widget( 'widget_newtheme_ephemera', __( 'New Theme Ephemera', 'newtheme' ), $widget_ops );
  11. $this->alt_option_name = 'widget_newtheme_ephemera';
  12.  
  13. add_action( 'save_post', array(&$this, 'flush_widget_cache' ) );
  14. add_action( 'deleted_post', array(&$this, 'flush_widget_cache' ) );
  15. add_action( 'switch_theme', array(&$this, 'flush_widget_cache' ) );
  16. }

Este método es el constructor del widget, le indica a WordPress la clase que utilizará, la desripción y el nombre del widget. Además se añaden varias acciones para volver a generar la cache cuando se guarde o elimine un post o cuando se cambie de tema.

  1. <?php
  2.  
  3. /**
  4. * Outputs the HTML for this widget.
  5. *
  6. * @param array An array of standard parameters for widgets in this theme
  7. * @param array An array of settings for this widget instance
  8. * @return void Echoes it's output
  9. **/
  10. function widget( $args, $instance ) {
  11. $cache = wp_cache_get( 'widget_newtheme_ephemera', 'widget' );
  12.  
  13. if ( !is_array( $cache ) )
  14. $cache = array();
  15.  
  16. if ( ! isset( $args['widget_id'] ) )
  17. $args['widget_id'] = null;
  18.  
  19. if ( isset( $cache[$args['widget_id']] ) ) {
  20. echo $cache[$args['widget_id']];
  21. return;
  22. }
  23.  
  24. extract( $args, EXTR_SKIP );
  25.  
  26. $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Ephemera', 'newtheme' ) : $instance['title'], $instance, $this->id_base);
  27.  
  28. if ( ! isset( $instance['number'] ) )
  29. $instance['number'] = '10';
  30.  
  31. if ( ! $number = absint( $instance['number'] ) )
  32. $number = 10;
  33.  
  34. $ephemera_args = array(
  35. 'order' => 'DESC',
  36. 'posts_per_page' => $number,
  37. 'no_found_rows' => true,
  38. 'post_status' => 'publish',
  39. 'post__not_in' => get_option( 'sticky_posts' ),
  40. 'tax_query' => array(
  41. 'taxonomy' => 'post_format',
  42. 'terms' => array( 'post-format-aside', 'post-format-link', 'post-format-status', 'post-format-quote' ),
  43. 'field' => 'slug',
  44. 'operator' => 'IN',
  45. ),
  46. ),
  47. );
  48. $ephemera = new WP_Query( $ephemera_args );
  49.  
  50. if ( $ephemera->have_posts() ) :
  51. echo $before_widget;
  52. echo $before_title;
  53. echo $title; // Can set this with a widget option, or omit altogether
  54. echo $after_title;
  55. ?>
  56. <ol>
  57. <?php while ( $ephemera->have_posts() ) : $ephemera->the_post(); ?>
  58.  
  59. <?php if ( 'link' != get_post_format() ) : ?>
  60.  
  61. <li class="widget-entry-title">
  62. <a href="<?php echo esc_url( get_permalink() ); ?>" title="<?php printf( esc_attr__( 'Permalink to %s', 'newtheme' ), the_title_attribute( 'echo=0' ) ); ?>" rel="bookmark"><?php the_title(); ?></a>
  63. <span class="comments-link">
  64. <?php comments_popup_link( __( '0 <span class="reply">comments &rarr;</span>', 'newtheme' ), __( '1 <span class="reply">comment &rarr;</span>', 'newtheme' ), __( '% <span class="reply">comments &rarr;</span>', 'newtheme' ) ); ?>
  65. </span>
  66. </li>
  67.  
  68. <?php else : ?>
  69.  
  70. <li class="widget-entry-title">
  71. <?php
  72. // Grab first link from the post content. If none found, use the post permalink as fallback.
  73. $link_url = newtheme_url_grabber();
  74.  
  75. if ( empty( $link_url ) )
  76. $link_url = get_permalink();
  77. ?>
  78. <a href="<?php echo esc_url( $link_url ); ?>" title="<?php printf( esc_attr__( 'Link to %s', 'newtheme' ), the_title_attribute( 'echo=0' ) ); ?>" rel="bookmark"><?php the_title(); ?>&nbsp;<span>&rarr;</span></a>
  79. <span class="comments-link">
  80. <?php comments_popup_link( __( '0 <span class="reply">comments &rarr;</span>', 'newtheme' ), __( '1 <span class="reply">comment &rarr;</span>', 'newtheme' ), __( '% <span class="reply">comments &rarr;</span>', 'newtheme' ) ); ?>
  81. </span>
  82. </li>
  83.  
  84. <?php endif; ?>
  85.  
  86. <?php endwhile; ?>
  87. </ol>
  88. <?php
  89.  
  90. echo $after_widget;
  91.  
  92. // Reset the post globals as this query will have stomped on it
  93. wp_reset_postdata();
  94.  
  95. // end check for ephemeral posts
  96. endif;
  97.  
  98. $cache[$args['widget_id']] = ob_get_flush();
  99. wp_cache_set( 'widget_newtheme_ephemera', $cache, 'widget' );
  100. }

Este método es un poco largo, así que voy a dividirlo y explicar el código.

  1. <?php
  2.  
  3. $cache = wp_cache_get( 'widget_newtheme_ephemera', 'widget' );
  4.  
  5. if ( !is_array( $cache ) )
  6. $cache = array();
  7.  
  8. if ( ! isset( $args['widget_id'] ) )
  9. $args['widget_id'] = null;
  10.  
  11. if ( isset( $cache[$args['widget_id']] ) ) {
  12. echo $cache[$args['widget_id']];
  13. return;
  14. }

Primero recuperamos los datos del widget desde la caché de WordPress.

Comprobamos que en caso de que no sea un array le damos el valor de un array vacío.

Comprobamos también que $args[‘widget_id’] no esta establecido y le damos el valor null.

Por último comprobamos que la caché disponga de algún contenido para el widget, si es así se muestra ese contenido y se devuelve un return para que php no siga ejecutando el método.

  1. <?php
  2.  
  3. extract( $args, EXTR_SKIP );
  4.  
  5. $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Ephemera', 'newtheme' ) : $instance['title'], $instance, $this->id_base);
  6.  
  7. if ( ! isset( $instance['number'] ) )
  8. $instance['number'] = '10';
  9.  
  10. if ( ! $number = absint( $instance['number'] ) )
  11. $number = 10;
  12.  
  13. $ephemera_args = array(
  14. 'order' => 'DESC',
  15. 'posts_per_page' => $number,
  16. 'no_found_rows' => true,
  17. 'post_status' => 'publish',
  18. 'post__not_in' => get_option( 'sticky_posts' ),
  19. 'tax_query' => array(
  20. 'taxonomy' => 'post_format',
  21. 'terms' => array( 'post-format-aside', 'post-format-link', 'post-format-status', 'post-format-quote' ),
  22. 'field' => 'slug',
  23. 'operator' => 'IN',
  24. ),
  25. ),
  26. );
  27. $ephemera = new WP_Query( $ephemera_args );

En el caso de que no haya contenido en la caché de WordPress, el método continuará ejecutandose.

En este extracto de código vemos como primero se abre el buffer de php utilizando la función ob_start(). Esta función permite que en vez de mostrar cualquier contenido que le siguiente, lo almacena en buffer para después poder mostrarlo donde corresponda con ob_get_flush().

A continuación se recupera el título y el número de post a mostrar.

Se crea un array con los parámetros para ejecutar una consulta SQL.

Por último se crea una nueva instancia de WP_Query() que devolverá los registros encontrados en la base de datos.

  1. <?php
  2.  
  3. if ( $ephemera->have_posts() ) :
  4. echo $before_widget;
  5. echo $before_title;
  6. echo $title; // Can set this with a widget option, or omit altogether
  7. echo $after_title;
  8. ?>
  9. <ol>
  10. <?php while ( $ephemera->have_posts() ) : $ephemera->the_post(); ?>
  11.  
  12. <?php if ( 'link' != get_post_format() ) : ?>
  13.  
  14. <li class="widget-entry-title">
  15. <a href="<?php echo esc_url( get_permalink() ); ?>" title="<?php printf( esc_attr__( 'Permalink to %s', 'newtheme' ), the_title_attribute( 'echo=0' ) ); ?>" rel="bookmark"><?php the_title(); ?></a>
  16. <span class="comments-link">
  17. <?php comments_popup_link( __( '0 <span class="reply">comments &rarr;</span>', 'newtheme' ), __( '1 <span class="reply">comment &rarr;</span>', 'newtheme' ), __( '% <span class="reply">comments &rarr;</span>', 'newtheme' ) ); ?>
  18. </span>
  19. </li>
  20.  
  21. <?php else : ?>
  22.  
  23. <li class="widget-entry-title">
  24. <?php
  25. // Grab first link from the post content. If none found, use the post permalink as fallback.
  26. $link_url = newtheme_url_grabber();
  27.  
  28. if ( empty( $link_url ) )
  29. $link_url = get_permalink();
  30. ?>
  31. <a href="<?php echo esc_url( $link_url ); ?>" title="<?php printf( esc_attr__( 'Link to %s', 'newtheme' ), the_title_attribute( 'echo=0' ) ); ?>" rel="bookmark"><?php the_title(); ?>&nbsp;<span>&rarr;</span></a>
  32. <span class="comments-link">
  33. <?php comments_popup_link( __( '0 <span class="reply">comments &rarr;</span>', 'newtheme' ), __( '1 <span class="reply">comment &rarr;</span>', 'newtheme' ), __( '% <span class="reply">comments &rarr;</span>', 'newtheme' ) ); ?>
  34. </span>
  35. </li>
  36.  
  37. <?php endif; ?>
  38.  
  39. <?php endwhile; ?>
  40. </ol>
  41. <?php
  42.  
  43. echo $after_widget;
  44.  
  45. // Reset the post globals as this query will have stomped on it
  46. wp_reset_postdata();
  47.  
  48. // end check for ephemeral posts
  49. endif;

Se comprueba si existen post para mostrar y si es que sí se muestran diferentes valores antes de iniciar el búcle que dará formato al contenido.

Se muestra cualquier contenido posterior al widget, se reincian los post globales que esta consulta haya podido pisar.

  1. <?php
  2.  
  3. $cache[$args['widget_id']] = ob_get_flush();
  4. wp_cache_set( 'widget_newtheme_ephemera', $cache, 'widget' );

Por último se guardan los datos del buffer en la caché de WordPress.

  1. <?php
  2.  
  3. /**
  4. * Deals with the settings when they are saved by the admin. Here is
  5. * where any validation should be dealt with.
  6. **/
  7. function update( $new_instance, $old_instance ) {
  8. $instance = $old_instance;
  9. $instance['title'] = strip_tags( $new_instance['title'] );
  10. $instance['number'] = (int) $new_instance['number'];
  11. $this->flush_widget_cache();
  12.  
  13. $alloptions = wp_cache_get( 'alloptions', 'options' );
  14. if ( isset( $alloptions['widget_newtheme_ephemera'] ) )
  15. delete_option( 'widget_newtheme_ephemera' );
  16.  
  17. return $instance;
  18. }

Este método permite verificar que los datos que ha introducido el administrador sean correctos y se guarden en la caché para futuros usos.

  1. <?php
  2.  
  3. function flush_widget_cache() {
  4. wp_cache_delete( 'widget_newtheme_ephemera', 'widget' );
  5. }

Este método elimina el widget de la caché de WordPress.

  1. <?php
  2.  
  3. /**
  4. * Displays the form for this widget on the Widgets page of the WP Admin area.
  5. **/
  6. function form( $instance ) {
  7. $title = isset( $instance['title']) ? esc_attr( $instance['title'] ) : '';
  8. $number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 10;
  9. ?>
  10. <p><label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php _e( 'Title:', 'newtheme' ); ?></label>
  11. <input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" /></p>
  12.  
  13. <p><label for="<?php echo esc_attr( $this->get_field_id( 'number' ) ); ?>"><?php _e( 'Number of posts to show:', 'newtheme' ); ?></label>
  14. <input id="<?php echo esc_attr( $this->get_field_id( 'number' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'number' ) ); ?>" type="text" value="<?php echo esc_attr( $number ); ?>" size="3" /></p>
  15. <?php
  16. }

Este último método crea el formulario donde el administrador podrá modificar el widget.

Cron Job WordPress

WordPress 3.x para desarrolladores: Temas y plantillas, theme-options.php

0

Nuestro tema va tomando poco a poco forma. Hoy vamos a crear el archivo theme-options.php que contendrá toda la lógica de las opciones de administración.

 

THEME-OPTIONS.PHP

Creamos el archivo theme-options.php y añadimos el siguiente código:

  1. <?php
  2.  
  3. /**
  4.  * Properly enqueue styles and scripts for our theme options page.
  5.  *
  6.  * This function is attached to the admin_enqueue_scripts action hook.
  7.  */
  8. function newtheme_admin_enqueue_scripts( $hook_suffix ) {
  9. wp_enqueue_style( 'newtheme-theme-options', get_template_directory_uri() . '/inc/theme-options.css', false, '2011-04-28' );
  10. wp_enqueue_script( 'newtheme-theme-options', get_template_directory_uri() . '/inc/theme-options.js', array( 'farbtastic' ), '2011-06-10' );
  11. wp_enqueue_style( 'farbtastic' );
  12. }
  13. add_action( 'admin_print_styles-appearance_page_theme_options', 'newtheme_admin_enqueue_scripts' );

Esta función añade un archivo css y un archivo javascript a la cabecera al apartado apariencia de la administración de WordPress.

  1. <?php
  2.  
  3. /**
  4.  * Register the form setting for our newtheme_options array.
  5.  *
  6.  * This function is attached to the admin_init action hook.
  7.  *
  8.  * This call to register_setting() registers a validation callback, newtheme_theme_options_validate(),
  9.  * which is used when the option is saved, to ensure that our option values are complete, properly
  10.  * formatted, and safe.
  11.  */
  12. function newtheme_theme_options_init() {
  13.  
  14. register_setting(
  15. 'newtheme_options', // Options group, see settings_fields() call in newtheme_theme_options_render_page()
  16. 'newtheme_theme_options', // Database option, see newtheme_get_theme_options()
  17. 'newtheme_theme_options_validate' // The sanitization callback, see newtheme_theme_options_validate()
  18. );
  19.  
  20. // Register our settings field group
  21. add_settings_section(
  22. 'general', // Unique identifier for the settings section
  23. '', // Section title (we don't want one)
  24. '__return_false', // Section callback (we don't want anything)
  25. 'theme_options' // Menu slug, used to uniquely identify the page; see newtheme_theme_options_add_page()
  26. );
  27.  
  28. // Register our individual settings fields
  29. add_settings_field(
  30. 'color_scheme', // Unique identifier for the field for this section
  31. __( 'Color Scheme', 'newtheme' ), // Setting field label
  32. 'newtheme_settings_field_color_scheme', // Function that renders the settings field
  33. 'theme_options', // Menu slug, used to uniquely identify the page; see newtheme_theme_options_add_page()
  34. 'general' // Settings section. Same as the first argument in the add_settings_section() above
  35. );
  36.  
  37. add_settings_field( 'link_color', __( 'Link Color', 'newtheme' ), 'newtheme_settings_field_link_color', 'theme_options', 'general' );
  38. add_settings_field( 'layout', __( 'Default Layout', 'newtheme' ), 'newtheme_settings_field_layout', 'theme_options', 'general' );
  39. }
  40. add_action( 'admin_init', 'newtheme_theme_options_init' );

Esta función registra la configuración por defecto del tema y añade varios apartados para la administración.

  1. <?php
  2.  
  3. /**
  4.  * Change the capability required to save the 'newtheme_options' options group.
  5.  *
  6.  * @see newtheme_theme_options_init() First parameter to register_setting() is the name of the options group.
  7.  * @see newtheme_theme_options_add_page() The edit_theme_options capability is used for viewing the page.
  8.  *
  9.  * By default, the options groups for all registered settings require the manage_options capability.
  10.  * This filter is required to change our theme options page to edit_theme_options instead.
  11.  * By default, only administrators have either of these capabilities, but the desire here is
  12.  * to allow for finer-grained control for roles and users.
  13.  *
  14.  * @param string $capability The capability used for the page, which is manage_options by default.
  15.  * @return string The capability to actually use.
  16.  */
  17. function newtheme_option_page_capability( $capability ) {
  18. return 'edit_theme_options';
  19. }
  20. add_filter( 'option_page_capability_newtheme_options', 'newtheme_option_page_capability' );

Esta función permite cambiar las opciones del tema. Es obligatorio para controlar los diversos usuarios y roles que tengan acceso.

  1. <?php
  2.  
  3. /**
  4.  * Add our theme options page to the admin menu, including some help documentation.
  5.  *
  6.  * This function is attached to the admin_menu action hook.
  7.  */
  8. function newtheme_theme_options_add_page() {
  9. $theme_page = add_theme_page(
  10. __( 'Theme Options', 'newtheme' ), // Name of page
  11. __( 'Theme Options', 'newtheme' ), // Label in menu
  12. 'edit_theme_options', // Capability required
  13. 'theme_options', // Menu slug, used to uniquely identify the page
  14. 'newtheme_theme_options_render_page' // Function that renders the options page
  15. );
  16.  
  17. if ( ! $theme_page )
  18. return;
  19.  
  20. add_action( "load-$theme_page", 'newtheme_theme_options_help' );
  21. }
  22. add_action( 'admin_menu', 'newtheme_theme_options_add_page' );

Añade la página de opciones de nuestro tema al menú de administración, incluyendo algo de documentación a la ayuda.

  1. <?php
  2.  
  3. function newtheme_theme_options_help() {
  4.  
  5. $help = '<p>' . __( 'Some themes provide customization options that are grouped together on a Theme Options screen. If you change themes, options may change or disappear, as they are theme-specific. Your current theme, Twenty Eleven, provides the following Theme Options:', 'newtheme' ) . '</p>' .
  6. '<ol>' .
  7. '<li>' . __( '<strong>Color Scheme</strong>: You can choose a color palette of "Light" (light background with dark text) or "Dark" (dark background with light text) for your site.', 'newtheme' ) . '</li>' .
  8. '<li>' . __( '<strong>Link Color</strong>: You can choose the color used for text links on your site. You can enter the HTML color or hex code, or you can choose visually by clicking the "Select a Color" button to pick from a color wheel.', 'newtheme' ) . '</li>' .
  9. '<li>' . __( '<strong>Default Layout</strong>: You can choose if you want your site&#8217;s default layout to have a sidebar on the left, the right, or not at all.', 'newtheme' ) . '</li>' .
  10. '</ol>' .
  11. '<p>' . __( 'Remember to click "Save Changes" to save any changes you have made to the theme options.', 'newtheme' ) . '</p>';
  12.  
  13. $sidebar = '<p><strong>' . __( 'For more information:', 'newtheme' ) . '</strong></p>' .
  14. '<p>' . __( '<a href="http://codex.wordpress.org/Appearance_Theme_Options_Screen" target="_blank">Documentation on Theme Options</a>', 'newtheme' ) . '</p>' .
  15. '<p>' . __( '<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>', 'newtheme' ) . '</p>';
  16.  
  17. $screen = get_current_screen();
  18.  
  19. if ( method_exists( $screen, 'add_help_tab' ) ) {
  20. // WordPress 3.3
  21. $screen->add_help_tab( array(
  22. 'title' => __( 'Overview', 'newtheme' ),
  23. 'id' => 'theme-options-help',
  24. 'content' => $help,
  25. )
  26. );
  27.  
  28. $screen->set_help_sidebar( $sidebar );
  29. } else {
  30. // WordPress 3.2
  31. add_contextual_help( $screen, $help . $sidebar );
  32. }
  33. }

Esta es la función que añade la ayuda que comentaba en la función anterior. Aquí además podemos ver como se añade un condicional para añadir retrocompatibilidad con versiones anteriores a la 3.3 y la 3.2.

  1. <?php
  2.  
  3. /**
  4.  * Returns an array of color schemes registered for New Theme.
  5.  */
  6. function newtheme_color_schemes() {
  7. $color_scheme_options = array(
  8. 'light' => array(
  9. 'value' => 'light',
  10. 'label' => __( 'Light', 'newtheme' ),
  11. 'thumbnail' => get_template_directory_uri() . '/inc/images/light.png',
  12. 'default_link_color' => '#1b8be0',
  13. ),
  14. 'dark' => array(
  15. 'value' => 'dark',
  16. 'label' => __( 'Dark', 'newtheme' ),
  17. 'thumbnail' => get_template_directory_uri() . '/inc/images/dark.png',
  18. 'default_link_color' => '#e4741f',
  19. ),
  20. );
  21.  
  22. return apply_filters( 'newtheme_color_schemes', $color_scheme_options );
  23. }

Esta función devuelve un array con los esquemas de color para cada versión del tema.

  1. <?php
  2.  
  3. /**
  4.  * Returns an array of layout options registered for New Theme.
  5.  */
  6. function newtheme_layouts() {
  7. $layout_options = array(
  8. 'content-sidebar' => array(
  9. 'value' => 'content-sidebar',
  10. 'label' => __( 'Content on left', 'newtheme' ),
  11. 'thumbnail' => get_template_directory_uri() . '/inc/images/content-sidebar.png',
  12. ),
  13. 'sidebar-content' => array(
  14. 'value' => 'sidebar-content',
  15. 'label' => __( 'Content on right', 'newtheme' ),
  16. 'thumbnail' => get_template_directory_uri() . '/inc/images/sidebar-content.png',
  17. ),
  18. 'content' => array(
  19. 'value' => 'content',
  20. 'label' => __( 'One-column, no sidebar', 'newtheme' ),
  21. 'thumbnail' => get_template_directory_uri() . '/inc/images/content.png',
  22. ),
  23. );
  24.  
  25. return apply_filters( 'newtheme_layouts', $layout_options );
  26. }

Devuelve un array con las opciones para cada tipo de estructura del diseño.

  1. <?php
  2.  
  3. /**
  4.  * Returns the default options for New Theme.
  5.  */
  6. function newtheme_get_default_theme_options() {
  7. $default_theme_options = array(
  8. 'color_scheme' => 'light',
  9. 'link_color' => newtheme_get_default_link_color( 'light' ),
  10. 'theme_layout' => 'content-sidebar',
  11. );
  12.  
  13. if ( is_rtl() )
  14. $default_theme_options['theme_layout'] = 'sidebar-content';
  15.  
  16. return apply_filters( 'newtheme_default_theme_options', $default_theme_options );
  17. }

Devuelve las opciones por defecto del tema.

  1. <?php
  2.  
  3. /**
  4.  * Returns the default link color for New Theme, based on color scheme.
  5.  *
  6.  *
  7.  * @param $string $color_scheme Color scheme. Defaults to the active color scheme.
  8.  * @return $string Color.
  9. */
  10. function newtheme_get_default_link_color( $color_scheme = null ) {
  11. if ( null === $color_scheme ) {
  12. $options = newtheme_get_theme_options();
  13. $color_scheme = $options['color_scheme'];
  14. }
  15.  
  16. $color_schemes = newtheme_color_schemes();
  17. if ( ! isset( $color_schemes[ $color_scheme ] ) )
  18. return false;
  19.  
  20. return $color_schemes[ $color_scheme ]['default_link_color'];
  21. }

Devuelve el color por defecto para los vínculos.

  1. <?php
  2.  
  3. /**
  4.  * Returns the options array for New Theme.
  5.  */
  6. function newtheme_get_theme_options() {
  7. return get_option( 'newtheme_theme_options', newtheme_get_default_theme_options() );
  8. }

Devuelve un array con todas las opciones del tema.

  1. <?php
  2.  
  3. /**
  4.  * Renders the Color Scheme setting field.
  5.  */
  6. function newtheme_settings_field_color_scheme() {
  7. $options = newtheme_get_theme_options();
  8.  
  9. foreach ( newtheme_color_schemes() as $scheme ) {
  10. ?>
  11. <div class="layout image-radio-option color-scheme">
  12. <label class="description">
  13. <input type="radio" name="newtheme_theme_options[color_scheme]" value="<?php echo esc_attr( $scheme['value'] ); ?>" <?php checked( $options['color_scheme'], $scheme['value'] ); ?> />
  14. <input type="hidden" id="default-color-<?php echo esc_attr( $scheme['value'] ); ?>" value="<?php echo esc_attr( $scheme['default_link_color'] ); ?>" />
  15. <span>
  16. <img src="<?php echo esc_url( $scheme['thumbnail'] ); ?>" width="136" height="122" alt="" />
  17. <?php echo $scheme['label']; ?>
  18. </span>
  19. </label>
  20. </div>
  21. <?php
  22. }
  23. }

Esta función genera el grupo de radio buttons que permitirá elegir entre un esquema de color u otro.

  1. <?php
  2.  
  3. /**
  4.  * Renders the Link Color setting field.
  5.  */
  6. function newtheme_settings_field_link_color() {
  7. $options = newtheme_get_theme_options();
  8. ?>
  9. <input type="text" name="newtheme_theme_options[link_color]" id="link-color" value="<?php echo esc_attr( $options['link_color'] ); ?>" />
  10. <a href="#" class="pickcolor hide-if-no-js" id="link-color-example"></a>
  11. <input type="button" class="pickcolor button hide-if-no-js" value="<?php esc_attr_e( 'Select a Color', 'newtheme' ); ?>" />
  12. <div id="colorPickerDiv" style="z-index: 100; background:#eee; border:1px solid #ccc; position:absolute; display:none;"></div>
  13. <br />
  14. <span><?php printf( __( 'Default color: %s', 'newtheme' ), '<span id="default-color">' . newtheme_get_default_link_color( $options['color_scheme'] ) . '</span>' ); ?></span>
  15. <?php
  16. }

Esta función genera el formulario para poder elegir el color de los vínculos.

  1. <?php
  2.  
  3. /**
  4.  * Renders the Layout setting field.
  5.  */
  6. function newtheme_settings_field_layout() {
  7. $options = newtheme_get_theme_options();
  8. foreach ( newtheme_layouts() as $layout ) {
  9. ?>
  10. <div class="layout image-radio-option theme-layout">
  11. <label class="description">
  12. <input type="radio" name="newtheme_theme_options[theme_layout]" value="<?php echo esc_attr( $layout['value'] ); ?>" <?php checked( $options['theme_layout'], $layout['value'] ); ?> />
  13. <span>
  14. <img src="<?php echo esc_url( $layout['thumbnail'] ); ?>" width="136" height="122" alt="" />
  15. <?php echo $layout['label']; ?>
  16. </span>
  17. </label>
  18. </div>
  19. <?php
  20. }
  21. }

Esta función genera el campo para elegir la estructura del blog.

  1. <?php
  2.  
  3. /**
  4.  * Returns the options array for New Theme.
  5.  */
  6. function newtheme_theme_options_render_page() {
  7. ?>
  8. <div class="wrap">
  9. <?php screen_icon(); ?>
  10. <?php $theme_name = function_exists( 'wp_get_theme' ) ? wp_get_theme() : get_current_theme(); ?>
  11. <h2><?php printf( __( '%s Theme Options', 'newtheme' ), $theme_name ); ?></h2>
  12. <?php settings_errors(); ?>
  13.  
  14. <form method="post" action="options.php">
  15. <?php
  16. settings_fields( 'newtheme_options' );
  17. do_settings_sections( 'theme_options' );
  18. submit_button();
  19. ?>
  20. </form>
  21. </div>
  22. <?php
  23. }

Función que genera todo el formulario de opciones.

  1. <?php
  2.  
  3. /**
  4.  * Sanitize and validate form input. Accepts an array, return a sanitized array.
  5.  *
  6.  * @see newtheme_theme_options_init()
  7.  * @todo set up Reset Options action
  8.  */
  9. function newtheme_theme_options_validate( $input ) {
  10. $output = $defaults = newtheme_get_default_theme_options();
  11.  
  12. // Color scheme must be in our array of color scheme options
  13. if ( isset( $input['color_scheme'] ) && array_key_exists( $input['color_scheme'], newtheme_color_schemes() ) )
  14. $output['color_scheme'] = $input['color_scheme'];
  15.  
  16. // Our defaults for the link color may have changed, based on the color scheme.
  17. $output['link_color'] = $defaults['link_color'] = newtheme_get_default_link_color( $output['color_scheme'] );
  18.  
  19. // Link color must be 3 or 6 hexadecimal characters
  20. if ( isset( $input['link_color'] ) && preg_match( '/^#?([a-f0-9]{3}){1,2}$/i', $input['link_color'] ) )
  21. $output['link_color'] = '#' . strtolower( ltrim( $input['link_color'], '#' ) );
  22.  
  23. // Theme layout must be in our array of theme layout options
  24. if ( isset( $input['theme_layout'] ) && array_key_exists( $input['theme_layout'], newtheme_layouts() ) )
  25. $output['theme_layout'] = $input['theme_layout'];
  26.  
  27. return apply_filters( 'newtheme_theme_options_validate', $output, $input, $defaults );
  28. }

Esta función valida que los datos del formulario son correctos.

  1. <?php
  2.  
  3. /**
  4.  * Enqueue the styles for the current color scheme.
  5.  */
  6. function newtheme_enqueue_color_scheme() {
  7. $options = newtheme_get_theme_options();
  8. $color_scheme = $options['color_scheme'];
  9.  
  10. if ( 'dark' == $color_scheme )
  11. wp_enqueue_style( 'dark', get_template_directory_uri() . '/colors/dark.css', array(), null );
  12.  
  13. do_action( 'newtheme_enqueue_color_scheme', $color_scheme );
  14. }
  15. add_action( 'wp_enqueue_scripts', 'newtheme_enqueue_color_scheme' );

Función que cambiará el estilo actual de la página dependiendo del color de esquema elegido.

  1. <?php
  2.  
  3. /**
  4.  * Add a style block to the theme for the current link color.
  5.  *
  6.  * This function is attached to the wp_head action hook.
  7.  */
  8. function newtheme_print_link_color_style() {
  9. $options = newtheme_get_theme_options();
  10. $link_color = $options['link_color'];
  11.  
  12. $default_options = newtheme_get_default_theme_options();
  13.  
  14. // Don't do anything if the current link color is the default.
  15. if ( $default_options['link_color'] == $link_color )
  16. return;
  17. ?>
  18. <style>
  19. /* Link color */
  20. a,
  21. #site-title a:focus,
  22. #site-title a:hover,
  23. #site-title a:active,
  24. .entry-title a:hover,
  25. .entry-title a:focus,
  26. .entry-title a:active,
  27. .widget_newtheme_ephemera .comments-link a:hover,
  28. section.recent-posts .other-recent-posts a[rel="bookmark"]:hover,
  29. section.recent-posts .other-recent-posts .comments-link a:hover,
  30. .format-image footer.entry-meta a:hover,
  31. #site-generator a:hover {
  32. color: <?php echo $link_color; ?>;
  33. }
  34. section.recent-posts .other-recent-posts .comments-link a:hover {
  35. border-color: <?php echo $link_color; ?>;
  36. }
  37. article.feature-image.small .entry-summary p a:hover,
  38. .entry-header .comments-link a:hover,
  39. .entry-header .comments-link a:focus,
  40. .entry-header .comments-link a:active,
  41. .feature-slider a.active {
  42. background-color: <?php echo $link_color; ?>;
  43. }
  44. </style>
  45. <?php
  46. }
  47. add_action( 'wp_head', 'newtheme_print_link_color_style' );

Función que añadirá el color a los vínculos a través de los estilos si este no es el mismo que el de defecto.

  1. <?php
  2.  
  3. /**
  4.  * Adds New Theme layout classes to the array of body classes.
  5.  */
  6. function newtheme_layout_classes( $existing_classes ) {
  7. $options = newtheme_get_theme_options();
  8. $current_layout = $options['theme_layout'];
  9.  
  10. if ( in_array( $current_layout, array( 'content-sidebar', 'sidebar-content' ) ) )
  11. $classes = array( 'two-column' );
  12. else
  13. $classes = array( 'one-column' );
  14.  
  15. if ( 'content-sidebar' == $current_layout )
  16. $classes[] = 'right-sidebar';
  17. elseif ( 'sidebar-content' == $current_layout )
  18. $classes[] = 'left-sidebar';
  19. else
  20. $classes[] = $current_layout;
  21.  
  22. $classes = apply_filters( 'newtheme_layout_classes', $classes, $current_layout );
  23.  
  24. return array_merge( $existing_classes, $classes );
  25. }
  26. add_filter( 'body_class', 'newtheme_layout_classes' );

Esta función añade las clases correspondientes a la etiqueta body dependiendo de la estructura de blog elegida.

  1. <?php
  2.  
  3. /**
  4.  * Implements New Theme theme options into Theme Customizer
  5.  *
  6.  * @param $wp_customize Theme Customizer object
  7.  * @return void
  8.  */
  9. function newtheme_customize_register( $wp_customize ) {
  10. $wp_customize->get_setting( 'blogname' )->transport = 'postMessage';
  11. $wp_customize->get_setting( 'blogdescription' )->transport = 'postMessage';
  12.  
  13. $options = newtheme_get_theme_options();
  14. $defaults = newtheme_get_default_theme_options();
  15.  
  16. $wp_customize->add_setting( 'newtheme_theme_options[color_scheme]', array(
  17. 'default' => $defaults['color_scheme'],
  18. 'type' => 'option',
  19. 'capability' => 'edit_theme_options',
  20. ) );
  21.  
  22. $schemes = newtheme_color_schemes();
  23. $choices = array();
  24. foreach ( $schemes as $scheme ) {
  25. $choices[ $scheme['value'] ] = $scheme['label'];
  26. }
  27.  
  28. $wp_customize->add_control( 'newtheme_color_scheme', array(
  29. 'label' => __( 'Color Scheme', 'newtheme' ),
  30. 'section' => 'colors',
  31. 'settings' => 'newtheme_theme_options[color_scheme]',
  32. 'type' => 'radio',
  33. 'choices' => $choices,
  34. 'priority' => 5,
  35. ) );
  36.  
  37. // Link Color (added to Color Scheme section in Theme Customizer)
  38. $wp_customize->add_setting( 'newtheme_theme_options[link_color]', array(
  39. 'default' => newtheme_get_default_link_color( $options['color_scheme'] ),
  40. 'type' => 'option',
  41. 'sanitize_callback' => 'sanitize_hex_color',
  42. 'capability' => 'edit_theme_options',
  43. ) );
  44.  
  45. $wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'link_color', array(
  46. 'label' => __( 'Link Color', 'newtheme' ),
  47. 'section' => 'colors',
  48. 'settings' => 'newtheme_theme_options[link_color]',
  49. ) ) );
  50.  
  51. // Default Layout
  52. $wp_customize->add_section( 'newtheme_layout', array(
  53. 'title' => __( 'Layout', 'newtheme' ),
  54. 'priority' => 50,
  55. ) );
  56.  
  57. $wp_customize->add_setting( 'newtheme_theme_options[theme_layout]', array(
  58. 'type' => 'option',
  59. 'default' => $defaults['theme_layout'],
  60. 'sanitize_callback' => 'sanitize_key',
  61. ) );
  62.  
  63. $layouts = newtheme_layouts();
  64. $choices = array();
  65. foreach ( $layouts as $layout ) {
  66. $choices[$layout['value']] = $layout['label'];
  67. }
  68.  
  69. $wp_customize->add_control( 'newtheme_theme_options[theme_layout]', array(
  70. 'section' => 'newtheme_layout',
  71. 'type' => 'radio',
  72. 'choices' => $choices,
  73. ) );
  74. }
  75. add_action( 'customize_register', 'newtheme_customize_register' );

Esta función añade todas las opciones al personalizador de temas.

  1. <?php
  2.  
  3. /**
  4.  * Bind JS handlers to make Theme Customizer preview reload changes asynchronously.
  5.  * Used with blogname and blogdescription.
  6.  */
  7. function newtheme_customize_preview_js() {
  8. wp_enqueue_script( 'newtheme-customizer', get_template_directory_uri() . '/inc/theme-customizer.js', array( 'customize-preview' ), '20120523', true );
  9. }
  10. add_action( 'customize_preview_init', 'newtheme_customize_preview_js' );

Esta función indica a WordPress que añada un archivo javascript para la previsualización de la página para poder ver los cambios del tema.

GestAuto 0.0.2.0 pre-alpha

5

Nueva versión del gestor de autoescuelas con los siguientes cambios:

Nueva pestaña Contabilidad. Ahora la aplicación permitirá gestionar de una forma básica la contabilidad de la autoescuela (ingresos y gastos).

Alertas de alumnos. Ahora la aplicación mostrará una alerta cada vez que se inicie la aplicación indicando si existen alumnos que  falten por pagar algún servicio.

Sistema de pago. Ahora al añadir un alumno a un curso se mostrará un mensaje para iniciar el pago del curso, permitiendo elegir entre tarjeta o efectivo y las cuotas en las que se dividirá el pago.

 

Se han corregido algunos errores y se ha actualizado la base de datos para las nuevas características.

 

Descargar: GestAuto 0.0.2.0 pre-alpha

Logo Cassandra

Cassandra 1.x y PHP para desarrolladores SQL: Cassandra Cluster Admin, el phpMyAdmin de Cassandra

3

En el anterior post expliqué el funcionamiento de la consola de Cassandra y como trabajar con ella. En este post explicaré como hacer lo mismo de una forma más rápida y fácil.

La razón de que no haya empezado ha explicar como se utiliza Cassandra desde PHP, es que primero hay que conocer cómo funciona Cassandra, su modelo de datos (que ya hemos visto) y algunos comandos básicos para ir aprendiendo a guardar y recuperar datos. El próximo post ya trataré el funcionamiento de PHPCassa y empezaremos a programar.

Este post será bastante ligerito. Explicaré principalmente como hacer lo mismo que hicimos por consola pero de modo gráfico. CassAdmin, como yo le llamo, tiene más opciones de edición para los keyspaces y column families de los que vamos a ver (igual que ocurría con la consola), pero solo tocaremos las opciones más habituales.

 

INSTALACIÓN

Lo típico en estos casos. Descargar. Descomprimir y ejecutar. Descargamos los archivos desde el repositorio de git: https://github.com/sebgiroux/Cassandra-Cluster-Admin, o a través de git o como archivo comprimido. Como más te guste.

Proceso para descargar Cassandra Cluster Admin

Página de descargas del administrador

Ahora descomprimimos a una carpeta dentro de nuestro servidor web, ya que trabajamos con una aplicación programada en PHP.

Si tienes Cassandra instalado en otro equipo que no sea en local, una máquina virtual por ejemplo, tendrás que cambiar la ip a la que se conecta cassAdmin. Es bastante sencillo. Para ello debes modificar el archivo includes/config.inc.php y sustituir la ip de localhost (127.0.0.1)  por la ip del equipo en el que tengas instalado Cassandra:

Archivo config.inc.php

Como verás en la captura, yo utilizo la ip local 192.168.1.10 que pertenece a una máquina virtual. Si tuviera instalado Cassandra en  el mismo equipo la ip a la que debería apuntar sería 127.0.0.1. El puerto no lo modificamos.

Una vez instalado y configurado (si fuese el caso) probamos a acceder desde nuestro navegador. Debería mostrarte algo como esto:

Página principal de Cassandra Cluster Admin

CREAR KEYSPACES

Como has podido ver, en la página principal del administrador ya aparece un keyspace, llamado system, perteneciente a Cassandra, con lo que lo mantendremos como está.

Justo encima tenemos un botón para crear un nuevo keyspace (Create a new keyspace). Lo pulsamos.

Formulario para crear un keyspace

Solo nos pide tres parámetros a rellenar:


Keyspace name
: El nombre del keyspace a crear.
Replication factor: Es el número de servidores o instancias de Cassandra de los que se debe guardar un registro u obtener una respuesta al recuperar algún registro.
Strategy: Es la estrategia que seguirá Cassandra para guardar los datos. En el caso de tener varios servidores o centro de datos diferenciados entre sí, se aplicará una estrategia u otra para que los datos no se pierdan. Más info: http://answers.oreilly.com/topic/2408-replica-placement-strategies-when-using-cassandra/ 

En nuestro caso escribiremos los siguientes valores:

Formulario para crear un keyspace con datos

Pulsamos en Create keyspace y nos llevará a la página principal:

Página principal mostrando el keyspace que acabamos de crear

Pulsamos sobre el keyspace que acabamos de crear y nos llevará a la siguiente página:

Página de detalle del keyspace my_keyspace

Aquí podemos ver información relativa al keyspace y al anillo (o cluster) en el que se encuentra guardado. También nos permite editar el keyspace o eliminarlo, pero la opción más interesante es la de crear nuevas column families (Create a new column family).

 

CREAR UNA COLUMN FAMILY

Dentro del keyspace pulsamos sobre el botón Create a new column family, nos mostrará lo siguiente:

Formulario para crear una column family

 

Primero crearemos una column family standard con los siguientes datos:

Datos para crear la primera column family

Para crear una column family solo son necesarios tres parámetros:


Column Family Name
: El nombre de la column family que vamos a crear.
Column Type: El tipo de column family que vamos a crear (Standard o Super).
Comparator Type: El comparador principal de las columnas. Es decir, la codificación que tendrán los datos dentro de la column family.

Pulsamos en Create Column Family y en la página de nuestro keyspace se habrá añadido una nueva column family:

Detalle de la column family creada

 

AÑADIR REGISTROS A UNA COLUMN FAMILY STANDARD

Ahora toca guardar registros en la BD.
Como comenté en post anteriores Cassandra no necesita conocer los campos de las tablas (nuestras column families) ya que los creamos cada vez que añadimos un registro.

Primero en la página principal del keyspace haz click en el nombre de la column family. Te aparecerá lo siguiente:

 

Detalle de la página principal de la column family creada

En esta página te aparecerá, además de la información referente a la column family, los siguientes botones:


Browse Data
: Para mostrar un listado de los registros que contiene la column family.
Create Secondary Index: Para crear indices secundarios. Parecido a los indices de MySQL.
Get Key: Para buscar una clave o registro concreto.
Insert Row: Para insertar un nuevo registro.
Edit Column Family: Para editar los parámetros de la column family.
Truncate Column Family: Para eliminar los registros de la column family sin eliminar esta.
Drop Column Family: Para eliminar la column family y su contenido.

Pulsamos en Insert Row. Nos aparecerá lo siguiente:

Formulario para insertar registros

Siempre que añadamos un nuevo registro deberemos indicar una key diferente que deberá ser única, sino cassAdmin pensará que lo que quieres hacer es actualizar ese registro. Añadimos los siguientes datos al formulario:

Formulario para insertar registros con datos

 

Para añadir otra fila de cuadro de texto solo tienes que pulsar el botón Add…
Volvemos a la página principal de la column family y pulsamos en Browse Data. Aquí veremos un listado con los registros que hayamos añadido:

 

Listado de registros

 

CREAR UNA COLUMN FAMILY SUPER Y AÑADIR REGISTROS

El proceso para crear una column family Super es idéntico a las column family Standard, solo hay que cambiar un valor a la hora de crearla:

Creación de una column family Super

Entramos en la página principal de la nueva column family y pulsamos en Insert Row. Aquí veremos que el formulario a cambiado un poco, nos aparece un nuevo campo llamado Super Column Name y un nuevo botón encima del formulario, Add Super Column:

Formulario para insertar registros de una column family super

Las column family Super son como las muñecas matrioskas, esas figuras que si las abrías había otra igual dentro, y dentro de esa otra más, y otra, etc. Algo parecido sucede con estas column family. Disponemos de una key (nuestra primera matrioska) que contiene a las super columns (segunda matrioska), que a su vez contienen las columnas clave:valor.

Añadamos un registro para verlo:

Datos para crear una super column

Si nos vamos a Browse Data:

Listado de registros en una column family Super

Como ves, ahora las columns se agruparían dentro de la super column. Añadiré más registros para que lo veas mejor:

Listado de registros en una column family Super

¿Ves? Las keys agrupan a las super columns y estas a su vez a las columns.

 

Creo que esto es suficiente para que conozcas el funcionamiento de Cassandra Cluster Admin. Quedarían algunas cosillas, como editar registros, hacer búsquedas o eliminar registros, pero eso es bastante sencillo (a excepción de las Secondary Index y las Counter Columns que trataré más adelante).

Para cualquier duda o problema déjala en los comentarios.

Logo Cassandra

Cassandra y PHP para desarrolladores SQL: Cassandra Cluster Admin, el phpMyAdmin de Cassandra

4

En el anterior post expliqué el funcionamiento de la consola de Cassandra y como trabajar con ella. En este post explicaré como hacer lo mismo de una forma más rápida y fácil.

La razón de que no haya empezado ha explicar como se utiliza Cassandra desde PHP, es que primero hay que conocer cómo funciona Cassandra, su modelo de datos (que ya hemos visto) y algunos comandos básicos para ir aprendiendo a guardar y recuperar datos. El próximo post ya trataré el funcionamiento de phpCassa y empezaremos a programar.

Este post será bastante ligerito. Explicaré principalmente como hacer lo mismo que hicimos por consola pero de modo gráfico. CassAdmin, como yo le llamo, tiene más opciones de edición para los keyspaces y column families de los que vamos a ver (igual que ocurría con la consola), pero solo tocaremos las opciones más habituales.

 

INSTALACIÓN

Lo típico en estos casos. Descargar. Descomprimir y ejecutar. Descargamos los archivos desde el repositorio de git: https://github.com/sebgiroux/Cassandra-Cluster-Admin, o a través de git o como archivo comprimido. Como más te guste.

Repositorio de Cassandra Cluster Admin

Página de descargas del administrador

Ahora descomprimimos a una carpeta dentro de nuestro servidor web, ya que trabajamos con una aplicación programada en PHP.

Si tienes Cassandra instalado en otro equipo que no sea en local, una máquina virtual por ejemplo, tendrás que cambiar la ip a la que se conecta cassAdmin. Es bastante sencillo. Para ello debes modificar el archivo includes/config.inc.php y sustituir la ip de localhost (127.0.0.1)  por la ip del equipo en el que tengas instalado Cassandra:

Archivo config.inc.php

Como verás en la captura, yo utilizo la ip local 192.168.1.10 que pertenece a una máquina virtual. Si tuviera instalado Cassandra en  el mismo equipo la ip a la que debería apuntar sería 127.0.0.1. El puerto no lo modificamos.

Una vez instalado y configurado (si fuese el caso) probamos a acceder desde nuestro navegador. Debería mostrarte algo como esto:

Página principal de Cassandra Cluster Admin

CREAR KEYSPACES

Como has podido ver, en la página principal del administrador ya aparece un keyspace, llamado system, perteneciente a Cassandra, con lo que lo mantendremos como está.

Justo encima tenemos un botón para crear un nuevo keyspace (Create a new keyspace). Lo pulsamos.

Formulario para crear un keyspace

Solo nos pide tres parámetros a rellenar:


Keyspace name
: El nombre del keyspace a crear.
Replication factor: Es el número de servidores o instancias de Cassandra de los que se debe guardar un registro u obtener una respuesta al recuperar algún registro.
Strategy: Es la estrategia que seguirá Cassandra para guardar los datos. En el caso de tener varios servidores o centro de datos diferenciados entre sí, se aplicará una estrategia u otra para que los datos no se pierdan. Más info: http://answers.oreilly.com/topic/2408-replica-placement-strategies-when-using-cassandra/ 

En nuestro caso escribiremos los siguientes valores:

Formulario para crear un keyspace con datos

Pulsamos en Create keyspace y nos llevará a la página principal:

Página principal mostrando el keyspace que acabamos de crear

Pulsamos sobre el keyspace que acabamos de crear y nos llevará a la siguiente página:

Página de detalle del keyspace my_keyspace

Aquí podemos ver información relativa al keyspace y al anillo (o cluster) en el que se encuentra guardado. También nos permite editar el keyspace o eliminarlo, pero la opción más interesante es la de crear nuevas column families (Create a new column family).

 

CREAR UNA COLUMN FAMILY

Dentro del keyspace pulsamos sobre el botón Create a new column family, nos mostrará lo siguiente:

Formulario para crear una column family

 

Primero crearemos una column family standard con los siguientes datos:

Datos para crear la primera column family

Para crear una column family solo son necesarios tres parámetros:


Column Family Name
: El nombre de la column family que vamos a crear.
Column Type: El tipo de column family que vamos a crear (Standard o Super).
Comparator Type: El comparador principal de las columnas. Es decir, la codificación que tendrán los datos dentro de la column family.

Pulsamos en Create Column Family y en la página de nuestro keyspace se habrá añadido una nueva column family:

Detalle de la column family creada

 

AÑADIR REGISTROS A UNA COLUMN FAMILY STANDARD

Ahora toca guardar registros en la BD.
Como comenté en post anteriores Cassandra no necesita conocer los campos de las tablas (nuestras column families) ya que los creamos cada vez que añadimos un registro.

Primero en la página principal del keyspace haz click en el nombre de la column family. Te aparecerá lo siguiente:

 

Detalle de la página principal de la column family creada

En esta página te aparecerá, además de la información referente a la column family, los siguientes botones:


Browse Data
: Para mostrar un listado de los registros que contiene la column family.
Create Secondary Index: Para crear indices secundarios. Parecido a los indices de MySQL.
Get Key: Para buscar una clave o registro concreto.
Insert Row: Para insertar un nuevo registro.
Edit Column Family: Para editar los parámetros de la column family.
Truncate Column Family: Para eliminar los registros de la column family sin eliminar esta.
Drop Column Family: Para eliminar la column family y su contenido.

Pulsamos en Insert Row. Nos aparecerá lo siguiente:

Formulario para insertar registros

Siempre que añadamos un nuevo registro deberemos indicar una key diferente que deberá ser única, sino cassAdmin pensará que lo que quieres hacer es actualizar ese registro. Añadimos los siguientes datos al formulario:

Formulario para insertar registros con datos

 

Para añadir otra fila de cuadro de texto solo tienes que pulsar el botón Add…
Volvemos a la página principal de la column family y pulsamos en Browse Data. Aquí veremos un listado con los registros que hayamos añadido:

 

Listado de registros

 

CREAR UNA COLUMN FAMILY SUPER Y AÑADIR REGISTROS

El proceso para crear una column family Super es idéntico a las column family Standard, solo hay que cambiar un valor a la hora de crearla:

Creación de una column family Super

Entramos en la página principal de la nueva column family y pulsamos en Insert Row. Aquí veremos que el formulario a cambiado un poco, nos aparece un nuevo campo llamado Super Column Name y un nuevo botón encima del formulario, Add Super Column:

Formulario para insertar registros de una column family super

Las column family Super son como las muñecas matrioskas, esas figuras que si las abrías había otra igual dentro, y dentro de esa otra más, y otra, etc. Algo parecido sucede con estas column family. Disponemos de una key (nuestra primera matrioska) que contiene a las super columns (segunda matrioska), que a su vez contienen las columnas clave:valor.

Añadamos un registro para verlo:

Datos para crear una super column

Si nos vamos a Browse Data:

Listado de registros en una column family Super

Como ves, ahora las columns se agruparían dentro de la super column. Añadiré más registros para que lo veas mejor:

Listado de registros en una column family Super

¿Ves? Las keys agrupan a las super columns y estas a su vez a las columns.

 

Creo que esto es suficiente para que conozcas el funcionamiento de Cassandra Cluster Admin. Quedarían algunas cosillas, como editar registros, hacer búsquedas o eliminar registros, pero eso es bastante sencillo (a excepción de las Secondary Index y las Counter Columns que trataré más adelante).

Para cualquier duda o problema déjala en los comentarios.

GestAuto, programa para gestión de autoescuelas

16

LA APLICACIÓN SE HA RELANZADO, SI QUIERES AYUDAR  PROBANDO LA APLICACIÓN O APORTANDO SUGERENCIAS SIGUE EL SIGUIENTE LINK: GestAuto 0.0.1.0 pre-alpha, la aplicación de gestión de autoescuelas open source se relanza

Hace un tiempo comencé a desarrollar una aplicación para la gestión de autoescuelas, que por desgracia no tengo tiempo para continuar desarrollando, y me daba pena que el trabajo de muchos meses se quedase olvidado en un rincón del disco duro. Al final me he decidido a publicar lo que tengo hecho y bajo la licencia GPL v3.

¡OJO! LA APLICACIÓN NO ESTÁ TERMINADA, (ya me gustaría) AUNQUE SI SE PUEDE PROBAR SIN QUE GENERE ERRORES O LA APLICACIÓN SE CIERRE. PERO REPITO, NO ESTÁ TERMINADA, Y NO ME HAGO RESPONSABLE DE LA PERDIDA DE DATOS QUE PUEDA PRODUCIR UN ERROR EN LA APLICACIÓN.

Datos técnicos de la aplicación:

  • Está programado en VB .NET (sí lo se, no es lo mejor para programar, pero a falta de conocimientos de C/C++, no me quedaba otra), está divido por clases y algún componente que tuve que crear. El código, no está precisamente muy comentado, (lo siento), aunque podréis preguntarme cualquier duda que tengais sobre el código.
  • Base de datos Access (sí, también lo se, no es precisamente lo mejor), aunque sería relativamente sencillo crear una clase para conectar con una base de datos MySQL, por ejemplo, ya que la conexion a la BD y los métodos de acceso a los datos, están en una clase separada del resto del código.
  • A través de MONO se podría ejecutar en GNU/Linux.

Características de la aplicación:

  • Puede manejar multiples autoescuelas (No recuerdo si comprobé que lo hacía correctamente, pero en principio estaba pensado para ello).
  • Puede manejar multiples tasas, matriculas, precios, ofertas, cursos, clases,  etc.
  • Puede elegirse un profesor para las clases teóricas y otro para las prácticas.
  • Impresión de documentos oficiales (Creo que solo imprimía la prueba de aptitud, y únicamente para la Comunidad de Madrid)
  • Listados de alumnos, profesores, vehículos, autoescuelas, etc.
  • Gestión de alumnos, profesores, autoescuelas y vehículos (Esta última parte la deshabilité del programa ya que aun no estaba acabada, aunque en el código si aparece y se puede habilitar la pestaña).
Ir arriba