Merge branch 'main' into hassan/asg-37-design-a-wall-of-love-page-for-eap-members-pre-eap-and-eap

Author: HassanZahirnia

resources/views/docs/desktop/1/the-basics/application.md

@@ -70,6 +70,28 @@ To get the current app version, use the `version` method. The version is defined
 $version = App::version();
 ```
 
+### Locale information
+
+The facade offers several methods for accessing some of the system's localisation information.
+This data can be helpful for localising your application, e.g. if you want to suggest the corresponding language to the user on first launch.
+
+```php
+App::getLocale(); // e.g. "de", "fr-FR"
+App::getLocaleCountryCode(); // e.g. "US", "DE"
+App::getSystemLocale(); // e.g. "it-IT", "de-DE"
+```
+
+The `getLocale` method will return the locale used by the app.
+Dependening on the user's settings, this might include both the language and the country / region or the language only.
+It is based on Chromiums `l10n_util` library; see [this page](https://source.chromium.org/chromium/chromium/src/+/main:ui/base/l10n/l10n_util.cc) to see possible values.
+
+`getLocaleCountryCode` returns the user's system country code (using the [ISO 3166 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+This information is pulled from native OS APIs. If it is not possible to detect this information, an empty string will be returned.
+
+With `getSystemLocale` you can access the system-wide locale setting. This is the locale set at the operating system level, not necessarily what the app is using.
+Under Windows and Linux, Chromium's `i18n` library is used to evaluate this information. macOS will use `[NSLocale currentLocale]`.
+
+
 ### App Badge Count
 _Only available on macOS and Linux_
 

resources/views/docs/desktop/1/the-basics/windows.md

@@ -394,6 +394,55 @@ Window::open()
 
 This is particularly useful for always-on-top utility windows or menubar applications that should not be visible in Mission Control.
 
+### Restrict navigation within a window
+
+When opening windows that display content that is not under your control (such as external websites), you may want to
+restrict the user's navigation options. NativePHP provides two handy methods for this on the `Window` facade:
+
+```php
+Window::open()
+    ->url('https://nativephp.com/')
+    ->preventLeaveDomain();
+
+Window::open()
+    ->url('https://laravel-news.com/bifrost')
+    ->preventLeavePage();
+```
+
+The `preventLeaveDomain()` method allows navigation within the same domain but blocks any attempt to navigate away to a
+different domain, scheme or port.
+
+With `preventLeavePage()` you can strictly confine the user to the initially rendered page. Any attempt to navigate to a
+different path (even within the same domain) will be blocked. However, in-page navigation via anchors (e.g. "#section")
+and updates to the query string remain permitted.
+
+#### Preventing new windows from popping up
+
+By default, Electron allows additional windows to be opened from a window that was previously opened programmatically.
+This is the case, for example, with `a` elements that have the target attribute set to `_blank` or when the user clicks on a link with the middle mouse button.
+This behaviour is potentially undesirable in a desktop application, as it enables the user to "break out" of a window.
+
+To prevent additional windows from opening, you can apply the `suppressNewWindows()` method when opening a new window.
+
+```php
+Window::open()
+    ->suppressNewWindows();
+```
+
+### Zoom factor
+
+In certain cases, you may want to set a zoom factor for a window.
+This can be particularly helpful in cases where you have no control over the content displayed (e.g. when showing external websites).
+You may use the `zoomFactor` method to define a zoom factor.
+
+```php
+Window::open()
+    ->zoomFactor(1.25);
+```
+
+The zoom factor is the zoom percent divided by 100.
+This means that you need to pass the value `1.25` if you want the window to be displayed at 125% size.
+
 ## Window Title Styles
 
 ### Default Title Style