nette · Krelyshy · Mar 1, 2023 · Mar 13, 2023 · Mar 14, 2023 · Mar 14, 2023
diff --git a/application/bg/@left-menu.texy b/application/bg/@left-menu.texy
@@ -15,5 +15,8 @@
 
 Допълнително четене
 *******************
+- [Защо да използвате Nette? |www:10-reasons-why-nette]
+- [Инсталация |nette:installation]
+- [Създайте първото си приложение! |quickstart:]
 - [Най-добри практики |best-practices:]
 - [Отстраняване на неизправности |nette:troubleshooting]
diff --git a/application/bg/ajax.texy b/application/bg/ajax.texy
@@ -10,9 +10,13 @@ AJAX и фрагменти
 
 </div>
 
-Заявката AJAX може да бъде открита чрез метода на услугата, който [капсулира HTTP заявката |http:request] `$httpRequest->isAjax()` (определя се въз основа на HTTP заглавието `X-Requested-With`). Съществува и съкратен метод в програмата за представяне: `$this->isAjax()`.
 
-Заявката AJAX не се различава от обикновената заявка - водещият се извиква с определено представяне и параметри. От водещия зависи и как ще реагира: той може да използва процедурите си, за да върне фрагмент от HTML код, XML документ, JSON обект или част от Javascript код.
+Заявка AJAX .[#toc-ajax-request]
+================================
+
+Заявката AJAX не се различава от класическата заявка - водещият се извиква с определен изглед и параметри. От водещия също зависи как да отговори на нея: той може да използва своя собствена процедура, която връща фрагмент от HTML код (HTML snippet), XML документ, JSON обект или JavaScript код.
+
+От страна на сървъра AJAX заявката може да бъде открита с помощта на метода на услугата, [капсулиращ HTTP заявката |http:request] `$httpRequest->isAjax()` (открива се въз основа на HTTP заглавието `X-Requested-With`). Вътре в презентатора е наличен пряк път под формата на метода `$this->isAjax()`.
 
 Съществува предварително обработен обект `payload`, предназначен за изпращане на данни към браузъра във формат JSON.
 
@@ -60,6 +64,21 @@ npm install naja
 <script src="https://unpkg.com/naja@2/dist/Naja.min.js"></script>
 ```
 
+За да създадете AJAX заявка от обикновена връзка (сигнал) или подаване на формуляр, просто маркирайте съответната връзка, формуляр или бутон с класа `ajax`:
+
+```html
+<a n:href="go!" class="ajax">Go</a>
+
+<form n:name="form" class="ajax">
+    <input n:name="submit">
+</form>
+
+or
+<form n:name="form">
+    <input n:name="submit" class="ajax">
+</form>
+```
+
 
 Извадки .[#toc-snippety]
 ========================
@@ -149,7 +168,7 @@ $this->isControlInvalid('footer'); // -> true
 В горния пример трябва да се уверите, че само един елемент ще бъде добавен към масива `$list`, когато бъде направена заявката AJAX, така че цикълът `foreach` ще изведе само един динамичен фрагмент.
 
 ```php
-class HomepagePresenter extends Nette\Application\UI\Presenter
+class HomePresenter extends Nette\Application\UI\Presenter
 {
 	/**
 	 * Этот метод возвращает данные для списка.

diff --git a/application/bg/bootstrap.texy b/application/bg/bootstrap.texy
@@ -174,7 +174,7 @@ $configurator->addStaticParameters([
 ]);
 ```
 
-Конфигурационните файлове могат да използват нормалния запис `%projectId%` за достъп до параметъра с име `projectId`. По подразбиране конфигураторът попълва следните параметри: `appDir`, `wwwDir`, `tempDir`, `vendorDir`, `debugMode` и `consoleMode`.
+В конфигурационните файлове можем да запишем обичайната нотация `%projectId%`, за да получим достъп до параметъра с име `projectId`.
 
 
 Динамични параметри .[#toc-dynamic-parameters]
@@ -197,6 +197,19 @@ $configurator->addDynamicParameters([
 ```
 
 
+Параметри по подразбиране .[#toc-default-parameters]
+----------------------------------------------------
+
+Можете да използвате следните статични параметри в конфигурационните файлове:
+
+- `%appDir%` е абсолютният път до директорията на файла `Bootstrap.php`
+- `%wwwDir%` е абсолютният път до директорията, съдържаща входния файл `index.php`
+- `%tempDir%` е абсолютният път до директорията за временни файлове
+- `%vendorDir%` е абсолютният път до директорията, в която Composer инсталира библиотеки
+- `%debugMode%` показва дали приложението е в режим на отстраняване на грешки
+- `%consoleMode%` показва дали заявката е постъпила от командния ред
+
+
 Внесени услуги .[#toc-imported-services]
 ----------------------------------------
 

diff --git a/application/bg/components.texy b/application/bg/components.texy
@@ -87,7 +87,7 @@ class PollControl extends Control
 Изобразяване на .[#toc-rendering]
 =================================
 
-Вече знаем, че тагът `{control componentName}` се използва за визуализиране на компонент. Всъщност се извиква методът `render()` на компонента, в който ние се грижим за рендирането. Както и в презентатора, имаме шаблон [Latte |latte:] в променливата `$this->template`, на който подаваме параметри. За разлика от използването в презентатора, тук трябва да посочим файла на шаблона и да го оставим да се визуализира:
+Вече знаем, че тагът `{control componentName}` се използва за визуализиране на компонент. Всъщност се извиква методът `render()` на компонента, в който ние се грижим за рендирането. Както и в презентатора, имаме [шаблон Latte |templates] в променливата `$this->template`, на който подаваме параметри. За разлика от използването в презентатора, тук трябва да посочим файла на шаблона и да го оставим да се визуализира:
 
 ```php .{file:PollControl.php}
 public function render(): void
@@ -233,31 +233,34 @@ $this->redirect(/* ... */); // пренасочване
 Постоянни параметри .[#toc-persistent-parameters]
 =================================================
 
-Често е необходимо да се запази даден параметър в компонент за целия период на експлоатация на компонента. Това може да бъде например номер на страница в странирането. Този параметър трябва да бъде отбелязан като постоянен с помощта на анотацията `@persistent`.
+Постоянните параметри се използват за поддържане на състоянието на компонентите между различните заявки. Тяхната стойност остава същата дори след щракване върху връзката. За разлика от данните за сесията, те се прехвърлят в URL адреса. И се прехвърлят автоматично, включително връзките, създадени в други компоненти на същата страница.
+
+Например, имате компонент за страниране на съдържание. На една страница може да има няколко такива компонента. И искате всички компоненти да останат на текущата си страница, когато щракнете върху връзката. Затова правим номера на страницата (`page`) постоянен параметър.
+
+Създаването на постоянен параметър е изключително лесно в Nette. Просто създайте публично свойство и го маркирайте с атрибута: (преди се използваше `/** @persistent */` )
 
 ```php
-class PollControl extends Control
+use Nette\Application\Attributes\Persistent; // този ред е важен
+
+class PaginatingControl extends Control
 {
-	/** @persistent */
-	public int $page = 1;
+	#[Persistent]
+	public int $page = 1; // трябва да бъдат публични
 }
 ```
 
-Този параметър ще се предава автоматично във всяка връзка като параметър `GET`, докато потребителят напусне страницата с този компонент.
+Препоръчваме ви да включите типа данни (например `int`) към свойството, като можете да включите и стойност по подразбиране. Стойностите на параметрите могат да бъдат [валидирани |#Validation of Persistent Parameters].
 
-.[caution]
-Никога не се доверявайте сляпо на постоянни параметри, тъй като те могат лесно да бъдат подправени (чрез презаписване на URL адреса). Проверете например дали номерът на страницата е в правилния интервал.
+Можете да променяте стойността на постоянен параметър, когато създавате връзка:
 
-В PHP 8 можете също така да използвате атрибути, за да маркирате постоянни параметри:
+```latte
+<a n:href="this page: $page + 1">next</a>
+```
 
-```php
-use Nette\Application\Attributes\Persistent;
+Или може да бъде *ресетнат*, т.е. да бъде премахнат от URL адреса. След това той ще приеме стойността си по подразбиране:
 
-class PollControl extends Control
-{
-	#[Persistent]
-	public int $page = 1;
-}
+```latte
+<a n:href="this page: null">reset</a>
 ```
 
 
@@ -378,7 +381,7 @@ interface PollControlFactory
 
 1) може да се показва в шаблон
 2) той знае каква част от себе си да покаже по време на [заявката AJAX |ajax#invalidation] (фрагменти)
-3) може да съхранява състоянието си в URL (параметри за устойчивост).
+3) има възможност да съхранява състоянието си в URL (постоянни параметри).
 4) има възможност да реагира на действията (сигналите) на потребителя.
 5) създава йерархична структура (където коренът е главният).
 
@@ -403,6 +406,33 @@ Nette\ComponentModel\Component  { IComponent }
 [* lifecycle-component.svg *] *** * Жизнен цикъл на компонента* .<>
 
 
+Утвърждаване на постоянни параметри .[#toc-validation-of-persistent-parameters]
+-------------------------------------------------------------------------------
+
+Стойностите на [постоянните параметри, |#persistent parameters] получени от URL адреси, се записват в свойствата чрез метода `loadState()`. Той също така проверява дали типът данни, зададен за свойството, съвпада, в противен случай ще отговори с грешка 404 и страницата няма да бъде показана.
+
+Никога не се доверявайте сляпо на постоянните параметри, защото те лесно могат да бъдат пренаписани от потребителя в URL адреса. Например, така проверяваме дали номерът на страницата `$this->page` е по-голям от 0. Добър начин да направите това е да презапишете метода `loadState()`, споменат по-горе:
+
+```php
+class PaginatingControl extends Control
+{
+	#[Persistent]
+	public int $page = 1;
+
+	public function loadState(array $params): void
+	{
+		parent::loadState($params); // тук се задава $this->page
+		// следва проверката на потребителската стойност:
+		if ($this->page < 1) {
+			$this->error();
+		}
+	}
+}
+```
+
+Противоположният процес, т.е. събирането на стойности от постоянни пропъртита, се обработва от метода `saveState()`.
+
+
 Сигнали в дълбочина .[#toc-signals-in-depth]
 --------------------------------------------
 

diff --git a/application/bg/creating-links.texy b/application/bg/creating-links.texy
@@ -52,7 +52,7 @@
 Атрибутът `n:href` е много полезен за HTML тагове. `<a>`. Ако искаме да покажем връзката на друго място, например в текста, използваме `{link}`:
 
 ```latte
-URL: {link Homepage:default}
+URL: {link Home:default}
 ```
 
 
@@ -88,7 +88,7 @@ $url = $this->link('Product:show', [$product->id, 'lang' => 'cs']);
 Следователно основната форма е `Presenter:action`:
 
 ```latte
-<a n:href="Homepage:default">главная страница</a>
+<a n:href="Home:default">главная страница</a>
 ```
 
 Ако се позоваваме на действието на текущия водещ, можем да пропуснем името му:
@@ -100,7 +100,7 @@ $url = $this->link('Product:show', [$product->id, 'lang' => 'cs']);
 Ако действието е `default`, можем да го пропуснем, но двоеточието трябва да остане:
 
 ```latte
-<a n:href="Homepage:">главная страница</a>
+<a n:href="Home:">главная страница</a>
 ```
 
 Връзките могат да сочат и към други [модули |modules]. Тук връзките се разграничават на относителни към подмодули или абсолютни. Принципът е подобен на дисковите пътища, само че с двоеточия вместо с наклонени черти. Да предположим, че водещият е част от модул `Front`, тогава записваме:
@@ -119,7 +119,7 @@ $url = $this->link('Product:show', [$product->id, 'lang' => 'cs']);
 Можем да направим връзка към определена част от HTML страницата чрез така наречения фрагмент след символа хеш `#`:
 
 ```latte
-<a n:href="Homepage:#main">ссылка на Homepage:default и фрагмент #main</a>
+<a n:href="Home:#main">ссылка на Home:default и фрагмент #main</a>
 ```
 
 
@@ -128,7 +128,7 @@ $url = $this->link('Product:show', [$product->id, 'lang' => 'cs']);
 
 Връзките, генерирани от `link()` или `n:href`, винаги са абсолютни пътища (т.е. започват с `/`), но не и абсолютни URL адреси с протокол и домейн, като `https://domain`.
 
-За да създадете абсолютен URL адрес, добавете две наклонени черти в началото (например `n:href="//Homepage:"`). Или можете да превключите презентатора да генерира само абсолютни връзки, като зададете `$this->absoluteUrls = true`.
+За да създадете абсолютен URL адрес, добавете две наклонени черти в началото (например `n:href="//Home:"`). Или можете да превключите презентатора да генерира само абсолютни връзки, като зададете `$this->absoluteUrls = true`.
 
 
 Връзка към текущата страница .[#toc-link-to-current-page]
@@ -213,13 +213,13 @@ $url = $this->link('Product:show', [$product->id, 'lang' => 'cs']);
 Ако искаме да направим препратка към презентаторите в шаблона на компонента, използваме тага `{plink}`:
 
 ```latte
-<a href="{plink Homepage:default}">главная страница</a>
+<a href="{plink Home:default}">главная страница</a>
 ```
 
 или в кода
 
 ```php
-$this->getPresenter()->link('Homepage:default')
+$this->getPresenter()->link('Home:default')
 ```