Skip to content

Commit 7f54afd

Browse files
committed
bug fixes markdown + change translates
1 parent 898e727 commit 7f54afd

8 files changed

Lines changed: 287 additions & 184 deletions

File tree

docs/es/access-handler.md

Lines changed: 33 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,34 @@
11
# Access handler
22

3-
Algunas veces quieres mostrar o esconder menu items, form fields, etc. para ciertos usuarios, con este componente se puede hacer sin necesidad de condicionales o código boilerplate.
3+
Algunas veces quieres mostrar o esconder elementos del menú, campos del formulario, etc... para ciertos usuarios; con este componente se puede hacer sin necesidad de condicionales o código boilerplate.
44

5-
Este paquete incluye una clase `BasicAccessHandler` pero puedes construir tu propia implementación de `AccessHandler`.
5+
Este paquete incluye una clase `BasicAccessHandler`, pero puedes construir tu propia implementación de `AccessHandler`.
66

77
## BasicAccessHandler
88

9-
Sólo pasa una de las siguientes opciones como un atributo de campo o valor del menu item:
9+
Sólo pasa una de las siguientes opciones como un atributo de campo o valor del elemento del menú:
1010

1111
1. *callback*: debe devolver true si se quiere dar acceso, false en caso contrario.
1212
2. *logged*: true: requiere que el usuario esté autenticado, false: requiere usuario invitado.
1313
3. *roles*: true si el usuario tiene uno de los roles requeridos.
1414
4. *allows*: usa el método Gate::allows.
1515
5. *check*: usa el método Gate::check (alias de allow).
1616
6. *denies*: usa el método Gate::denies.
17-
7. Si ninguna opción es pasada, éste devolverá true (el item será renderizado).
17+
7. Si ninguna opción es pasada, éste devolverá true (el elemento será renderizado).
1818

1919
*WARNING*: tomar en cuenta que este paquete sólo evitará que los elementos aparezcan en el frontend, aún se necesita proteger el acceso de backend usando middleware, etc.
2020

2121
Uso:
2222

23-
####Form fields
23+
#### Campos de formulario
2424

25-
`{!! Field::select('user_id', null, ['roles' => 'admin'])`
25+
```blade
26+
{!! Field::select('user_id', null, ['roles' => 'admin'])
27+
```
2628

27-
####Menu items
29+
#### Elementos de menú
2830

29-
```
31+
```php
3032
// config/menu.php
3133

3234
return [
@@ -43,8 +45,10 @@ return [
4345
]
4446
];
4547
```
46-
47-
`{!! Menu::make('menu.items') !}}`
48+
49+
```blade
50+
{!! Menu::make('menu.items') !}}
51+
```
4852

4953
## Autorización y políticas de acceso
5054

@@ -56,14 +60,19 @@ Si es un array, la primera posición del array será el nombre de la habilidad y
5660

5761
Ejemplos:
5862

59-
`{!! Field::text('change-password', ['allows' => 'change-password']) !!}`
60-
`{!! Field::select('category', $options, ['allows' => ['change-post-category', $category]]) !!}`
63+
```blade
64+
{!! Field::text('change-password', ['allows' => 'change-password']) !!}
65+
```
66+
67+
```blade
68+
{!! Field::select('category', $options, ['allows' => ['change-post-category', $category]]) !!}
69+
```
6170

6271
Si estás contruyendo menús puedes usar parámetros dinámicos para pasar valores a la autorización.
6372

6473
En el siguiente ejemplo definiremos un parámetro dinámico 'post' y pasarlo usando setParam cuando se construya el menú:
6574

66-
```
75+
```php
6776
// config/menu.php
6877

6978
return [
@@ -75,18 +84,20 @@ return [
7584
]
7685
];
7786
```
78-
79-
`{!! Menu::make('menu.items')->setParam('post', $post)->render() !}}`
80-
87+
88+
```blade
89+
{!! Menu::make('menu.items')->setParam('post', $post)->render() !}}
90+
```
91+
8192
## Personalización
8293

83-
Si estás trabajando en un proyecto complejo con muchas reglas de acceso diferentes, etc. puedes necesitar implementar un AccessHandler propio. Para hacer esto, crea una nueva clase que implemente la interface `Styde\Html\Access\AccessHandler`, entonces extiende el HtmlServiceProvider y sustituye el método `registerAccessHandler`.
94+
Si estás trabajando en un proyecto complejo con muchas reglas de acceso diferentes, etc... puedes necesitar implementar un AccessHandler propio. Para hacer esto, crea una nueva clase que implemente la interface `Styde\Html\Access\AccessHandler`, entonces extiende el HtmlServiceProvider y sustituye el método `registerAccessHandler`.
8495

8596
## Standalone
8697

8798
Si se quiere usar la clase del access handler como un componente independiente, por favor agrega este alias global en `config/app.php`.
8899

89-
```
100+
```php
90101
'aliases' => [
91102
// ...
92103
'Access' => Styde\Html\Facades\Access,
@@ -96,7 +107,7 @@ Si se quiere usar la clase del access handler como un componente independiente,
96107

97108
Luego se puede utilizar la facade donde se quiera:
98109

99-
```
110+
```blade
100111
@if (Access:check(['roles' => ['admin, 'editor']]))
101112
<p>
102113
<a href='{{ url('admin/posts', [$post->id]) }}'>
@@ -106,11 +117,11 @@ Luego se puede utilizar la facade donde se quiera:
106117
@endif
107118
```
108119

109-
##Desactivar el access handler
120+
## Desactivar el access handler
110121

111122
Se puede desactivar este componente en la configuración:
112123

113-
```
124+
```php
114125
//config/html.php
115126
return [
116127
//..
@@ -119,4 +130,4 @@ return [
119130
];
120131
```
121132

122-
Haciendo esto, los atributos callback, logged y roles serán simplemente ignorados, y todos los usuarios serán capaces de ver todos los items.
133+
Haciendo esto, los atributos callback, logged y roles serán simplemente ignorados, y todos los usuarios serán capaces de ver todos los elementos.

docs/es/alert-messages.md

Lines changed: 54 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -2,89 +2,104 @@
22

33
Este componente permitirá generar mensajes de alerta complejos.
44

5-
```
6-
Alert::info('Su cuenta está a punto de caducar')
7-
->details('Renueva ahora para aprender acerca de:')
8-
->items([
9-
'Laravel',
10-
'PHP,
11-
'y más',
12-
])
13-
->button('¡Renueva ahora!', '#', 'primary');
5+
```php
6+
Alert::info('Su cuenta está a punto de caducar')
7+
->details('Renueva ahora para aprender acerca de:')
8+
->items([
9+
'Laravel',
10+
'PHP',
11+
'y más',
12+
])
13+
->button('¡Renueva ahora!', '#', 'primary');
1414
```
1515

16-
Los mensajes serán persistentes en el sesión hasta que sean presentados al usuario con:
16+
Los mensajes serán persistentes en la sesión hasta que sean presentados al usuario con:
1717

18-
`{!! Alert::render() !!}`
18+
```blade
19+
{!! Alert::render() !!}
20+
```
1921

2022
## Crear un nuevo mensaje de alerta
2123

2224
Se puede generar un nuevo mensaje de alerta con:
2325

24-
`{!! Alert::message('Este es el mensaje', 'tipo-alerta') !!}`
26+
```blade
27+
{!! Alert::message('Este es el mensaje', 'tipo-alerta') !!}
28+
```
2529

2630
El primer argumento es el texto del mensaje y el segundo es el tipo de alerta.
2731

2832
Por ejemplo:
2933

30-
```
31-
Alert::message('El final está cerca', 'danger');
34+
```blade
35+
{!! Alert::message('El final está cerca', 'danger') !!}
3236
```
3337

3438
También se puede usar métodos mágicos, el nombre del método se convierte en el tipo de alerta:
3539

36-
```
37-
Alert::success("Está todo bien ahora");
40+
```blade
41+
{!! Alert::success("Está todo bien ahora") !!}
3842
```
3943

4044
## Encadenamiento de métodos
4145

4246
Se puede especificar más opciones por encadenamiento de métodos:
4347

44-
###details
48+
### Detalles
4549

4650
Se puede pasar uno o más mensajes detallados encadenando el método details():
4751

48-
`{!! Alert::info('Algo de información')->details('Una explicación más detallada va aquí') !!}`
52+
```blade
53+
{!! Alert::info('Algo de información')->details('Una explicación más detallada va aquí') !!}
54+
```
4955

50-
###Llamadas de acción
56+
### Llamadas de acción
5157

5258
Se puede asignar botones a un mensaje de alerta:
5359

54-
`{!! Alert::info()->button('Llamada de acción', 'alguna-url', 'primary') !!}`
60+
```blade
61+
{!! Alert::info()->button('Llamada de acción', 'alguna-url', 'primary') !!}
62+
```
5563

56-
###html
64+
### HTML
5765

58-
Se puede directamente pasar HTML a un mensaje de alerta:
66+
Se puede pasar HTML directamente a un mensaje de alerta:
5967

60-
`{!! Alert::info()->html('<strong>El HTML va aquí</strong>') !!}`
68+
```blade
69+
{!! Alert::info()->html('<strong>El HTML va aquí</strong>') !!}
70+
```
6171

6272
Tenga cuidado ya que esto no será escapado.
6373

64-
###view
74+
### Vista
6575

6676
Se puede incluso renderizar una vista dentro de un mensaje de alerta:
6777

68-
`{!! Alert::info()->view('partials/alerts/partial') !!}`
78+
```blade
79+
{!! Alert::info()->view('partials/alerts/partial') !!}
80+
```
6981

70-
###items
82+
### Elementos
7183

72-
Se puede pasar un array de items (tal vez una lista de errores):
84+
Se puede pasar un array de elementos (tal vez una lista de errores):
7385

74-
`{!! Alert::danger('Por favor corrija los siguientes errores')->items($errors) !!}`
86+
```blade
87+
{!! Alert::danger('Por favor corrija los siguientes errores')->items($errors) !!}
88+
```
7589

76-
##Persistir los mensajes de alerta
90+
## Persistir los mensajes de alerta
7791

7892
Agrega el siguiente middleware al array `$middleware` en `app/Http/Kernel.php` **ANTES** de `\App\Http\Middleware\EncryptCookies`:
7993

80-
```
94+
```php
8195
protected $middleware = [
8296
//...
8397
\Styde\Html\Alert\Middleware::class
8498
//...
8599
];
86100
```
87-
Se necesita este middleware para persistir los mensajes de alerta después de que se complete cada request.
101+
102+
Se necesita este middleware para persistir los mensajes de alerta después de que se complete cada petición.
88103

89104
Por defecto, los mensajes de alerta serán persistidos usando el componente session de Laravel. Pero también se puede crear una implementación propia.
90105

@@ -94,7 +109,7 @@ Si la opción `'translate_texts'` está definida como true en la configuración
94109

95110
Si no se necesita utilizar el componente Traductor, sólo define translate_texts como false en la configuración:
96111

97-
```
112+
```php
98113
//config/html.php
99114
return [
100115
//...
@@ -103,12 +118,15 @@ return [
103118
];
104119
```
105120

106-
## Themes
121+
## Temas
107122

108-
Por defecto, los mensajes de alerta serán renderizados con la plantilla predeterminada, localizada en themes/[theme]/alert, por ejemplo, para el tema de Bootstrap theme que sería:
123+
Por defecto, los mensajes de alerta serán renderizados con la plantilla predeterminada, localizada en themes/[nombre-del-tema]/alert, por ejemplo, para el tema de Bootstrap sería:
109124

110125
`vendor/styde/html/themes/bootstrap/alert.blade.php`
111126

112-
Se puede pasar un plantilla personalizada como el primer argumento del método render(), es decir:
127+
Se puede pasar una plantilla personalizada como el primer argumento del método render(), es decir:
128+
129+
```blade
130+
{!! Alert::render('partials/custom-alert-template') !!}
131+
```
113132

114-
`{!! Alert::render('partials/custom-alert-template') !!}`

0 commit comments

Comments
 (0)