Merge pull request #151 from vlados/claude/issue-5-20251001-2037

docs: add getSlug() method and usage examples to API documentation

Author: vlados

README.md

@@ -169,6 +169,7 @@ class LivewireComponentExample extends Component
 | **Methods**                     	 | Description                                                 	| Parameters         	|
 |-----------------------------------|-------------------------------------------------------------	|--------------------	|
 | generateUrl()                   	 | Generate manually the URL                                   	|                    	|
+| getSlug()                       	 | Get the URL for a specific language in relative or absolute format | ?string $language = '', bool $relative = true |
 | urlStrategy                     	 | The strategy for creating the URL for the model             	| $language, $locale 	|
 | isAutoGenerateUrls()            	 | Disable generating urls on creation, globally for the model 	|                    	|
 | disableGeneratingUrlsOnCreate() 	 | Disable generating urls on creation                         	|                    	|
@@ -178,6 +179,25 @@ class LivewireComponentExample extends Component
 | **Relations**                   	 |                                                             	|                    	|
 | urls()                          	 | All the active urls, related to the current model           	|                    	|
 
+### Getting Model URLs
+
+```php
+// Get relative URL for current locale
+$model->relative_url; // e.g., "my-product-name"
+
+// Get absolute URL for current locale
+$model->absolute_url; // e.g., "https://example.com/my-product-name"
+
+// Get URL for specific language (relative)
+$model->getSlug('en', true); // e.g., "my-product-name"
+
+// Get URL for specific language (absolute)
+$model->getSlug('en', false); // e.g., "https://example.com/my-product-name"
+
+// Get URL for current locale (defaults to app locale)
+$model->getSlug(); // e.g., "my-product-name"
+```
+
 ## Commands
 ### urls:generate
 This command generates unique URLs for the specified model or all models in the application that implement the `HasUniqueUrls` trait.