Source

cruge / README.md

Diff from to

File README.md

 
 Extensión para el Control de Usuarios y Roles.
 
-[**Ir al repositorio de Cruge Bitbucket**](https://bitbucket.org/christiansalazarh/cruge "Repositorio de Cruge en Bitbucket")
+##Que es Cruge ?
+
+Cruge es una Avanzada Extensión y API para el Control de Usuarios y Roles en Yii Framework. dispone de:
+
+* editor visual de Roles, tareas y operaciones, hecho en Ajax.
+* registro, login, lostpassword.
+* gestion avanzada de usuarios.
+* campos de perfil personalizables en linea.
+* uso avanzado de correos basados en vistas.
+
+Cruge dispone de un API de alto nivel y varias de bajo nivel, no solo es una simple extensión, es toda un API, por tanto dispones de avanzados controles de OOP para gestionar sesiones, monitorear, controlar eventos y mas.
+
+[Documentación en Línea (WIKI)](http://yiiframeworkenespanol.org/cruge/ "Documentación en Línea (WIKI)")
 
 [visita mi blog](http://trucosdeprogramacionmovil.blogspot.com/ "Visita mi Blog")
 
 
 [PROYECTO BASICO DE DEMOSTRACION](https://bitbucket.org/christiansalazarh/crugeholamundo/ "Cruge Demo")
 
-[Descargar Documentación PDF](https://bitbucket.org/christiansalazarh/cruge/downloads/Cruge.pdf "Descargar Documentación PDF")
-
-[Documentación en Línea (WIKI)](http://yiiframeworkenespanol.org/cruge/ "Documentación en Línea (WIKI)")
-
 ![screenshots][1]
 
 ##Requisitos de Plataforma
 
 * Yii Framework 1.10,  1.11, 1.12, 1.13
 
-##Que es Cruge ?
+##Instalación
 
- Cruge te permite administrar y controlar de forma muy eficiente y segura a tus usuarios y los roles que ellos deban tener en tu aplicación.
+ Por favor ve a sitio WIKI de documentación en línea para que conozcas mas detalles de como instalar.
 
 ##DOCUMENTACION
 
-Siempre es preferible la documentación en línea, aqui dispones de un Cruge WIKI :
-
-[Documentación en Línea (WIKI)](http://yiiframeworkenespanol.org/cruge/ "Documentación en Línea (WIKI)")
-
-También una versión PDF aunque no se garantiza que siempre esté al día con la WIKI:
-
-[Descargar Documentación PDF](https://bitbucket.org/christiansalazarh/cruge/downloads/Cruge.pdf "Descargar Documentación PDF")
-
-##Instalación
-
-Primero voy a asumir que Cruge ha sido descargado a tu carpeta:
-
-	/protected/modules/cruge/
-
-puedes descargar cruge directamente desde un ZIP, o mediante un comando GIT como: git clone [URL DE GIT].
-
-En el archivo de configuración de tu aplicación (config/main.php) deberás colocar lo siguiente:
-
-	1.	dentro de 'import' agregar:
-			'application.modules.cruge.components.*',
-			'application.modules.cruge.extensions.crugemailer.*',
-
-	2.	dentro de 'modules' agregar:
-			'cruge'=>array(
-				'tableprefix'=>'cruge_',
-
-				// para que utilice a protected.modules.cruge.models.auth.CrugeAuthDefault.php
-				//
-				// en vez de 'default' pon 'authdemo' para que utilice el demo de autenticacion alterna
-				// para saber mas lee documentacion de la clase modules/cruge/models/auth/AlternateAuthDemo.php
-				//
-				'availableAuthMethods'=>array('default'),
-
-				'availableAuthModes'=>array('username','email'),
-				'baseUrl'=>'http://coco.com/',
-
-				 // NO OLVIDES PONER EN FALSE TRAS INSTALAR
-				 'debug'=>true,
-				 'rbacSetupEnabled'=>true,
-				 'allowUserAlways'=>true,
-
-				// MIENTRAS INSTALAS..PONLO EN: false
-				// lee mas abajo respecto a 'Encriptando las claves'
-				//
-				'useEncryptedPassword' => false,
-
-				// Algoritmo de la función hash que deseas usar
-				// Los valores admitidos están en: http://www.php.net/manual/en/function.hash-algos.php
-				'hash' => 'md5',
-
-				// a donde enviar al usuario tras iniciar sesion, cerrar sesion o al expirar la sesion.
-				//
-				// esto va a forzar a Yii::app()->user->returnUrl cambiando el comportamiento estandar de Yii
-				// en los casos en que se usa CAccessControl como controlador
-				//
-				// ejemplo:
-				//		'afterLoginUrl'=>array('/site/welcome'),  ( !!! no olvidar el slash inicial / )
-				//		'afterLogoutUrl'=>array('/site/page','view'=>'about'),
-				//
-				'afterLoginUrl'=>null,
-				'afterLogoutUrl'=>null,
-				'afterSessionExpiredUrl'=>null,
-
-				// manejo del layout con cruge.
-				//
-				'loginLayout'=>'//layouts/main',
-				'registrationLayout'=>'//layouts/main',
-				'activateAccountLayout'=>'//layouts/main',
-				'editProfileLayout'=>'//layouts/main',
-				// en la siguiente puedes especificar el valor "ui" o "column2" para que use el layout
-				// de fabrica, es basico pero funcional.  si pones otro valor considera que cruge
-				// requerirá de un portlet para desplegar un menu con las opciones de administrador.
-				//
-				'generalUserManagementLayout'=>'ui',
-			),
-
-	3.	dentro de 'components' agregar:
-	        //
-			//  IMPORTANTE:  asegurate de que la entrada 'user' (y format) que por defecto trae Yii
-			//               sea sustituida por estas a continuación:
-			//
-			'user'=>array(
-				'allowAutoLogin'=>true,
-				'class' => 'application.modules.cruge.components.CrugeWebUser',
-				'loginUrl' => array('/cruge/ui/login'),
-			),
-			'authManager' => array(
-				'class' => 'application.modules.cruge.components.CrugeAuthManager',
-			),
-			'crugemailer'=>array(
-				'class' => 'application.modules.cruge.components.CrugeMailer',
-				'mailfrom' => 'email-desde-donde-quieres-enviar-los-mensajes@xxxx.com',
-				'subjectprefix' => 'Tu Encabezado del asunto - ',
-				'debug' => true,
-			),
-			'format' => array(
-				'datetimeFormat'=>"d M, Y h:m:s a",
-			),
-
-	4.	crea las tablas requeridas en la base de datos de tu aplicacion, usa el script:
-
-		<tuaplicacion>/protected/modules/cruge/data/cruge-data-model.sql
-
-		aqui se va a crear automaticamente un usuario para que puedas comenzar, toma nota
-
-			usuario=admin
-			clave=admin
-
-	5.  Configura el menu de tu aplicacion para que incopore a Cruge, para ello
-	edita tu archivo:
-		/protected/views/layouts/main.php
-	y sustituye el componente CMenu por el que te doy a continuacion.
-
-		<?php $this->widget('zii.widgets.CMenu',array(
-			'items'=>array(
-				array('label'=>'Home', 'url'=>array('/site/index')),
-				array('label'=>'About', 'url'=>array('/site/page', 'view'=>'about')),
-				array('label'=>'Contact', 'url'=>array('/site/contact')),
-				array('label'=>'Administrar Usuarios'
-					, 'url'=>Yii::app()->user->ui->userManagementAdminUrl
-					, 'visible'=>!Yii::app()->user->isGuest),
-				array('label'=>'Login'
-					, 'url'=>Yii::app()->user->ui->loginUrl
-					, 'visible'=>Yii::app()->user->isGuest),
-				array('label'=>'Logout ('.Yii::app()->user->name.')'
-					, 'url'=>Yii::app()->user->ui->logoutUrl
-					, 'visible'=>!Yii::app()->user->isGuest),
-			),
-		)); ?>
+ [Documentación en Línea (WIKI)](http://yiiframeworkenespanol.org/cruge/ "Documentación en Línea (WIKI)")
 
 [1]: https://bitbucket.org/christiansalazarh/cruge/downloads/screenshots.gif