You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+15-26Lines changed: 15 additions & 26 deletions
Original file line number
Diff line number
Diff line change
@@ -42,14 +42,13 @@ For all available methods, see the [Helpers](src/Support/Helpers.php) class.
42
42
43
43
## Translation Service Provider
44
44
45
-
> Enhanced logging for missing translations and variables.
45
+
> Logs missing translations and translation variables in the current language. Throws an exception when not in production environment. In debug mode, checks all available languages.
46
46
47
-
- **Missing Translation Logging**: Logs warnings when a translation key is missing.
48
-
- **Missing Variables Logging**: Logs warnings when variables required in a translation string are not provided.
49
-
- **All Locale Check**: In debug mode, it checks all available locales for missing translations and variables.
50
-
- **TranslatorException**: Throws an `InternetGuru\LaravelCommon\Exceptions\TranslatorException` exception instead of logging when the app is not in production mode.
47
+
- **Logs warning** when a translation key is missing or a variable required in a translation string is not provided.
48
+
- **Checks all languages** in debug mode from all available locales.
49
+
- **Throws exception** `InternetGuru\LaravelCommon\Exceptions\TranslatorException` instead of logging when the app is not in production mode.
51
50
52
-
Add the following lines to the `config/app.php` file to use the `TranslationServiceProvider`:
51
+
To use the provider, add the following lines to the `config/app.php` file:
53
52
54
53
```php
55
54
use Illuminate\Support\ServiceProvider;
@@ -77,21 +76,15 @@ class Task extends Model
77
76
}
78
77
```
79
78
80
-
## Blade Components
79
+
## Breadcrumb Blade Component
81
80
82
-
> The package provides a set of Blade components for Laravel applications.
83
-
84
-
### Breadcrumb
85
-
86
-
> The Breadcrumb Blade component renders breadcrumb navigation in your application, helping users understand their location within the app's hierarchy.
81
+
> Renders breadcrumb navigation based on routes matching the current URL segments. Supports translations with short and long labels, custom divider, and segment skipping.
87
82
88
83
Key Features:
89
84
90
-
-**Automatic Path Parsing**: Automatically parses the current URL and generates breadcrumb items based on your routes and translations.
91
-
-**Customizable Divider**: Allows customization of the divider symbol between breadcrumb items.
92
-
-**Localization Support**: Supports translation of breadcrumb items using Laravel's localization system.
93
-
-**Short and Long Labels**: Supports both short and long labels for breadcrumb items.
94
-
-**Segment Skipping**: Optionally skip a specified number of URL segments, useful for nested routes or prefixes.
85
+
-**Customizable Divider** – Allows a custom divider symbol between breadcrumb items.
86
+
-**Short and Long Labels** – Using `trans_choice` if available shows n-th right translation based on the item positon.
87
+
-**Segment Skipping** – Skips a specified number of URL segments. Useful for nested routes or routes with prefixes (e.g. language).
95
88
96
89
Usage:
97
90
@@ -143,23 +136,23 @@ Example:
143
136
Long Application Name
144
137
```
145
138
146
-
### System Messages
139
+
## System Messages Blade Component
147
140
148
-
> The `messages` Blade component renders system success messages and error messages.
141
+
> Renders system temporary success messages and persistent error messages in different colors, with a close button.
149
142
150
143
Include the component in your Blade template where you want the system messages to appear:
151
144
152
145
```html
153
146
<x-ig::system-messages />
154
147
```
155
148
156
-
###Form Inputs
149
+
## Form Blade Components
157
150
158
-
> The package provides a set of Blade components for form inputs.
151
+
> The package provides a set of Blade components for form and various inputs.
159
152
160
153
Notes:
161
154
162
-
- Google Recaptcha V3 is enabled by default. To disable it, set the `recaptcha` attribute to `false`.
155
+
-The [Google Recaptcha V3](https://developers.google.com/recaptcha/docs/v3) service is enabled by default. To disable it, set the `recaptcha` attribute to `false`.
163
156
- You need to install the [internetguru/laravel-recaptchav3](https://github.com/internetguru/laravel-recaptchav3) package for the Recaptcha to work.
164
157
165
158
Complete example:
@@ -190,10 +183,6 @@ To run the tests, use the following command:
190
183
191
184
This package uses [Orchestra Testbench](https://github.com/orchestral/testbench) to bootstrap a minimal Laravel environment for testing.
192
185
193
-
## Changelog
194
-
195
-
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
196
-
197
186
## License
198
187
199
188
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
0 commit comments