Commits

christiansalazar committed 70ceace

actualizando informacion de filtros y readme

  • Participants
  • Parent commits 381d639

Comments (0)

Files changed (1)

 
 Extensión para el Control de Usuarios y Roles.
 
+[**Ir al repositorio de Cruge Bitbucket**](https://bitbucket.org/christiansalazarh/cruge "ir al repositorio en bitbucket")
+
+[visita mi blog](http://trucosdeprogramacionmovil.blogspot.com/ "visita mi blog")
+
+[Comunidad de Yii Framework en Espańol](http://yiiframeworkenespanol.org/ "Comunidad de Yii Framework en Espańol")
+
 ![screenshots][1]
 
 ##Que es Cruge ?
  
 ---
 
-#Instalación 
+##Instalación 
 
 Primero voy a asumir que Cruge ha sido descargado a tu carpeta: 
 
 	
 ---
 		
-#Uso básico de Cruge
+##Uso básico de Cruge
  
-####Obtener un usuario:
+##Obtener un usuario:
  
 	 <?php 
 		$usuario = Yii::app()->user->um->loadUser('admin@gmail.com',true);
 		// por defecto es : false.
 	 ?>
 
-####Campos Personalizados:
+##Campos Personalizados:
 
 	<?php
 		echo "Su nombre es: ";
 		
 	?>
 	 
-####Verificar un permiso de acceso:
+##Verificar un permiso de acceso:
 		aqui se pretende verificar si el usuario activo tiene asignado el rol 'admin':
 	
 		<?php if(Yii::app()->user->checkAccess('admin')){ ... } ?>
 	 
-####Acceder a las variables del sistema:
+##Acceder a las variables del sistema:
 		<?php if(Yii::app()->user->um->getDefaultSystem()->getn('registerusingcaptcha')==1){...} ?>
 
-####Acceder a la Interfaz de Usuario de Cruge: 
+##Acceder a la Interfaz de Usuario de Cruge: 
 	Puedes invocar al API UI de Cruge para acceder a los enlaces:
 
 		<?php echo Yii::app()->user->ui->getLoginLink('iniciar sesion'); ?>
 	<?php echo Yii::app()->user->ui->registrationLink; ?>
 	
 	
-#Personalizando el Layout
+##Personalizando el Layout
 
 Cruge te permite que su interfaz de usuario predeterminada pueda ajustarse a tu sitio web usando lo que en Yii se conoce como Layouts. 
 
 
 	Yii::app()->user->ui->adminItems
 	
-#Usando RBAC
+##Usando RBAC
 
 RBAC es el sistema de control de acceso basado en roles (por sus siglas en ingles).  Todo el mecanismo RBAC puede ser manejado mediante la interfaz (UI) de Cruge, o mediante su API. Las dos modalidades para usar en este mecanismo son:
 
 
 Si tu quieres denegar el acceso a un action de un controller simplemente no le asignas al usuario la operacion que tenga el nombre del action: 'action_nombrecontroller_nombreaction'. 
 	
-#Modo de Programacion del RBAC
+##Modo de Programacion del RBAC
 	
 Para activarlo, en la configuracion de tu aplicacion debes considerar estos dos argumentos:
 
 
 	(no siempre se veran los mensajes de permisos requeridos, para ello usa el log, lee el item a continuacion)
 	
-#Usando el LOG 	
+##Usando el LOG 	
 	
 Adicionalmente todos los errores de permiso que se generen seran reportados en el log bajo el key 'rbac', para poder visualizar los errores en protected/runtime/application.log deberas configurar tu config/main.php para indicar el key del log:
 
 		tipo:operacion
 		itemName:action_catalog_imageh
 	
-#EL usuario Invitado
+##EL usuario Invitado
 
 Cruge hace especial tratamiento al usuario invitado. Para esto CrugeModule contiene un atributo llamado **guestUserId** , el cual es usado para indicarle al sistema Cruge cual de sus usuarios existentes en la base de datos de usuarios es el invitado. 
 
 
 Puedes confiar en Yii::app()->user->isGuest.  ya que ésta considera todo esto para saber si el usuario es un invitado.
 
+##Filtros
+
+Cruge permite que se pueda extender mas alla usando filtros. Existen varios tipos de filtros, todos se instalan en config/main y disponen de una interfaz (interface) que debes respetar, a continuación la lista de filtros, si necesitas crear un filtro nuevo fijate en como esta hecho el filtro por defecto:
+
+* **filtros de autenticacion:**
+permite que amplies como se busca un usuario para ser autenticado.
+protected\modules\cruge\models\auth\CrugeAuthDefault.php
+
+* **filtros de sesion:**
+permite que puedas controlar como se entrega una sesion a un usuario, inclusive puedes denegarla.
+protected\modules\cruge\models\filters\DefaultSessionFilter.php
+
+* **filtro de actualizacion:**
+permite saber si un usuario actualizo su perfil.
+protected\modules\cruge\models\filters\DefaultUserFilter.php
+
+Debido a lo extenso de Cruge no he tenido tiempo de documentar bien estos filtros, pero es bastante intuitivo. 
+
+
+##Traduccion
+
+Si ves, Cruge escribe los mensajes en espańol, mientras que su codigo esta en inglés. Todos los mensajes se dirigen a la clase CrugeTranslator::t("mensaje en espańol"), por tanto ese es el punto para traducir a otro idioma. En un futuro nuevo commit hare un nuevo filtro, para traducir, sin que tengas que tocar nada dentro de CrugeTranslator.
+
+
 
 
 [1]: https://bitbucket.org/christiansalazarh/cruge/downloads/screenshots.gif