Diferencia entre revisiones de «Integrar KumbiaPHP Spirit con TinyMCE»

De KumbiaPHP Framework Wiki
 
(No se muestran 9 ediciones intermedias de 5 usuarios)
Línea 1: Línea 1:
TinyMCE es un editor WYSIWYG de reconocimeinto mundial que a los desarrolladores nos resulta muy util para proporcionar un editor de texto a los usuarios, facil de usar rapido y con controles intuitivos. ''Recordemos que se maneja bajo la licencia LGPL''
+
{{cleanupbox
 +
|image=[[Archivo:Information_icon4.png|45px]]
 +
|texto ='''Este Artículo cumple con todos los quererimientos de los Kumbieros.'''<br />
 +
}}
 +
 
 +
 
 +
[http://tinymce.moxiecode.com/ TinyMCE] es un editor [http://es.wikipedia.org/wiki/WYSIWYG WYSIWYG] de reconocimiento mundial que a los desarrolladores nos resulta muy útil para proporcionar un editor de texto a los usuarios, fácil de usar, rápido y con controles intuitivos. ''Recordemos que se maneja bajo la licencia LGPL''
  
 
En este tutorial veremos como podemos integrarlo (TinyMCE) a nuestro APP con KumbiaPHP.
 
En este tutorial veremos como podemos integrarlo (TinyMCE) a nuestro APP con KumbiaPHP.
Línea 7: Línea 13:
 
== Instalar TinyMCE ==
 
== Instalar TinyMCE ==
  
Luego de tener Kumnbiaphp en nuestro servidor, descargaremos el editor desde la  [http://tinymce.moxiecode.com/download.php web Oficial] seleccionamos la opcion mas conveniente. Para el caso descargaremso Main package
+
Luego de tener Kumbiaphp en nuestro servidor, descargaremos el editor desde la  [http://tinymce.moxiecode.com/download.php web Oficial] seleccionamos la opción mas conveniente. Para el caso descargaremos Main package
  
 
Al descargarlo y descomprimirlo tenemos:
 
Al descargarlo y descomprimirlo tenemos:
Línea 21: Línea 27:
 
== Llamado al editor mediante un partial ==
 
== Llamado al editor mediante un partial ==
  
Ahora debemos llamar dicho scrip desde el formulario que tengamos en kumbiaphp y para facilitar el proceso usaremos un Partial (views/partials/tinymce_simple.phtml)
+
Ahora debemos llamar dicho script desde el formulario que tengamos en kumbiaphp y para facilitar el proceso usaremos un Partial (views/partials/tinymce_simple.phtml)
  
Mediante el uso del Helper javascript_include_tag(); estamos inclullendo la libreria principal de TinyMCE que tiene por nombre tiny_mce.js
+
Mediante el uso del Helper javascript_include_tag(); estamos incluyendo la librería principal de TinyMCE que tiene por nombre tiny_mce.js
 
<source lang=php line>
 
<source lang=php line>
 
<?php
 
<?php
Línea 44: Línea 50:
 
     //language : "es",
 
     //language : "es",
 
     remove_linebreaks : false,
 
     remove_linebreaks : false,
     theme_advanced_buttons1 : "bold,italic,underline,strikethrough,separator,sup,sub,separator,bullist,
+
     theme_advanced_buttons1 : "bold,italic,underline,strikethrough,separator,sup,sub,separator,bullist,numlist,formatselect,undo,redo,link,unlink,image,visualaid,charmap,
numlist,formatselect,undo,redo,link,unlink,image,visualaid,charmap,cleanup,
+
cleanup,code,separator,emotions,forecolor,backcolor,|,justifyleft,justifycenter,justifyright,justifyfull,",
code,separator,emotions,forecolor,backcolor,|,justifyleft,justifycenter,justifyright,justifyfull,",
 
 
     theme_advanced_buttons2 : "",
 
     theme_advanced_buttons2 : "",
 
     theme_advanced_buttons3 : "",
 
     theme_advanced_buttons3 : "",
Línea 68: Línea 73:
 
</source>
 
</source>
  
Luego de tenr el partial y todo el contenido de tinyMCE en nuestro servidor procedemos a aplicarlo en un formulario que tengamos. El partial anterior hara que los TexArea de lso formularios contengan un editor de texto con el formato que se especifica en el Partial.
+
Luego de tener el partial y todo el contenido de tinyMCE en nuestro servidor procedemos a aplicarlo en un formulario que tengamos. El partial anterior hara que los TexArea de los formularios contengan un editor de texto con el formato que se especifica en el Partial.
  
 
+
== Ejecución del editor TinyMCE en un formulario ==
== Ejecucion del editor TinyMCE en un formulario ==
 
  
 
Como podemos ver en este formulario, el textarea_tag no incluye nunca una referencia al editor TinyMCE, es el partial quien se encarga de asociarlo. (El formulario puede estar incluido en una vista cualquiera)
 
Como podemos ver en este formulario, el textarea_tag no incluye nunca una referencia al editor TinyMCE, es el partial quien se encarga de asociarlo. (El formulario puede estar incluido en una vista cualquiera)
Línea 105: Línea 109:
 
</source>
 
</source>
  
Es importante recalcar que se debe incluir el partial luego de haber definido el texarea. de lo contrario no se asosiara a dicho textarea
+
Es importante recalcar que se debe incluir el partial luego de haber definido el texarea. de lo contrario no se asociara a dicho textarea
  
 
'''Resultado'''
 
'''Resultado'''
 +
 
[[Archivo: Formulario_con_TinyMCE.jpg]]
 
[[Archivo: Formulario_con_TinyMCE.jpg]]
 +
 +
[[Categoría:Tutoriales KumbiaPHP]]
 +
[[Categoría:Views]]
 +
[[Categoría:Partials]]

Revisión actual del 19:29 7 ago 2010

{{#if:Information icon4.png |}}

{{#if:

|}}



TinyMCE es un editor WYSIWYG de reconocimiento mundial que a los desarrolladores nos resulta muy útil para proporcionar un editor de texto a los usuarios, fácil de usar, rápido y con controles intuitivos. Recordemos que se maneja bajo la licencia LGPL

En este tutorial veremos como podemos integrarlo (TinyMCE) a nuestro APP con KumbiaPHP.


Instalar TinyMCE[editar]

Luego de tener Kumbiaphp en nuestro servidor, descargaremos el editor desde la web Oficial seleccionamos la opción mas conveniente. Para el caso descargaremos Main package

Al descargarlo y descomprimirlo tenemos:

Dibujo1.jpg

La carpeta Examples viene con ejemplos de como incluir el editor de varias formas, personalizando las barras de herramientas temas y layout.

La carpeta scripts contiene la carpeta tiny_mce es esta carpeta y su contenido que debemos subir a nuestro APP de KumbiaPHP. Lo haremos en la carpeta public/javascript

Directorios javascript.jpg

Llamado al editor mediante un partial[editar]

Ahora debemos llamar dicho script desde el formulario que tengamos en kumbiaphp y para facilitar el proceso usaremos un Partial (views/partials/tinymce_simple.phtml)

Mediante el uso del Helper javascript_include_tag(); estamos incluyendo la librería principal de TinyMCE que tiene por nombre tiny_mce.js

<?php
	echo javascript_include_tag('tiny_mce/tiny_mce');
?>


Contenido de: views/partials/tinymce_simple.phtml

<?php
	echo javascript_include_tag('tiny_mce/tiny_mce');
?>

<script language="javascript" type="text/javascript">

tinyMCE.init({
    mode : "textareas",
    theme : "advanced",
    //language : "es",
    remove_linebreaks : false,
    theme_advanced_buttons1 : "bold,italic,underline,strikethrough,separator,sup,sub,separator,bullist,numlist,formatselect,undo,redo,link,unlink,image,visualaid,charmap,
cleanup,code,separator,emotions,forecolor,backcolor,|,justifyleft,justifycenter,justifyright,justifyfull,",
    theme_advanced_buttons2 : "",
    theme_advanced_buttons3 : "",
    theme_advanced_toolbar_location : "top",
    theme_advanced_toolbar_align : "left",
    theme_advanced_path_location : "",
    //extended_valid_elements : //"a[name|href|target|title],img[class|src|border=0|alt|title|hspace|
//vspace|width|height|align|name], hr[class|width|size|noshade],span[class]",
    entity_encoding : "raw",
	relative_urls : false,
	
	theme_advanced_statusbar_location : "bottom",
	theme_advanced_resizing : true,
	
	skin : "o2k7",
	skin_variant : "black",
	plugins : "emotions",
	
    });
</script>

Luego de tener el partial y todo el contenido de tinyMCE en nuestro servidor procedemos a aplicarlo en un formulario que tengamos. El partial anterior hara que los TexArea de los formularios contengan un editor de texto con el formato que se especifica en el Partial.

Ejecución del editor TinyMCE en un formulario[editar]

Como podemos ver en este formulario, el textarea_tag no incluye nunca una referencia al editor TinyMCE, es el partial quien se encarga de asociarlo. (El formulario puede estar incluido en una vista cualquiera)

Formulario de ejemplo:

<table>
    <tr>
        <td>Titulo</td>
        <td><?php echo text_field_tag(array('blog.titulo'),"size: 40","maxlength: 145") ?></td>
    </tr>
    <tr>
        <td>Articulo</td>
        <td><?php echo textarea_tag('blog.articulo',"cols: 80", "rows: 20"); ?></td>
    </tr>
    <tr>
        <td>Tags</td>
        <td><?php echo text_field_tag(array('blog.tags')) ?></td>
    </tr>
    <tr>
        <td>&nbsp;</td>
        <td><?php echo submit_tag('Publicar articulo') ?></td>
    </tr>
</table>
<?php  echo end_form_tag();
echo link_to("blog/index","Ir al inicio");

//Aqui llamamos al partial que asociara un area de texto de este formulario al editor TinyMCE
view::partial('tinymce_simple'); 

?>

Es importante recalcar que se debe incluir el partial luego de haber definido el texarea. de lo contrario no se asociara a dicho textarea

Resultado

Formulario con TinyMCE.jpg