More clear description of sendJSON() method

.github/workflows/coding-style.yml

@@ -0,0 +1,17 @@
+name: Coding Style
+
+on: [push, pull_request]
+
+jobs:
+    nette_cc:
+        name: Nette Code Checker
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v3
+            - uses: shivammathur/setup-php@v2
+              with:
+                  php-version: 8.3
+                  coverage: none
+
+            - run: composer create-project nette/code-checker temp/code-checker ^3 --no-progress
+            - run: php temp/code-checker/code-checker --no-progress

application/bg/@home.texy

@@ -28,8 +28,9 @@ composer require nette/application
 
 | версия на пакета | съвместима версия на PHP
 |-----------------------|-----------------------
-| Nette Application 4.0 | PHP 8.0 - 8.1
-| Nette Application 3.1 | PHP 7.2 - 8.1
+| Nette Application 4.0 | PHP 8.1 – 8.3
+| Nette Application 3.2 | PHP 8.1 – 8.3
+| Nette Application 3.1 | PHP 7.2 – 8.3
 | Nette Application 3.0 | PHP 7.1 - 8.0
 | Nette Application 2.4 | PHP 5.6 - 8.0
 

application/bg/bootstrap.texy

@@ -20,18 +20,44 @@ use Nette\Bootstrap\Configurator;
 
 class Bootstrap
 {
-	public static function boot(): Configurator
+	private Configurator $configurator;
+	private string $rootDir;
+
+	public function __construct()
+	{
+		$this->rootDir = dirname(__DIR__);
+		// Конфигураторът отговаря за настройката на средата на приложението и услугите.
+		$this->configurator = new Configurator;
+		// Задайте директорията за временни файлове, генерирани от Nette (напр. компилирани шаблони)
+		$this->configurator->setTempDirectory($this->rootDir . '/temp');
+	}
+
+	public function bootWebApplication(): Nette\DI\Container
 	{
-		$appDir = dirname(__DIR__);
-		$configurator = new Configurator;
-		//$configurator->setDebugMode('[email protected]');
-		$configurator->enableTracy($appDir . '/log');
-		$configurator->setTempDirectory($appDir . '/temp');
-		$configurator->createRobotLoader()
+		$this->initializeEnvironment();
+		$this->setupContainer();
+		return $this->configurator->createContainer();
+	}
+
+	private function initializeEnvironment(): void
+	{
+		// Nette е интелигентен и режимът за разработка се включва автоматично,
+		// или можете да го включите за определен IP адрес, като разкоментирате следния ред:
+		// $this->configurator->setDebugMode('[email protected]');
+
+		// Активира Tracy: най-добрият инструмент за отстраняване на грешки "швейцарско ножче".
+		$this->configurator->enableTracy($this->rootDir . '/log');
+
+		// RobotLoader: автоматично зарежда всички класове в дадената директория
+		$this->configurator->createRobotLoader()
 			->addDirectory(__DIR__)
 			->register();
-		$configurator->addConfig($appDir . '/config/common.neon');
-		return $configurator;
+	}
+
+	private function setupContainer(): void
+	{
+		// Зареждане на конфигурационни файлове
+		$this->configurator->addConfig($this->rootDir . '/config/common.neon');
 	}
 }
 ```
@@ -40,16 +66,15 @@ class Bootstrap
 index.php .[#toc-index-php]
 ===========================
 
-В случая на уеб приложения началният файл е `index.php`, който се намира в публичната директория `www/`. Той позволява на класа `Bootstrap` да инициализира средата и връща `$configurator`, който създава контейнера DI. След това тя извлича услугата `Application`, която стартира уеб приложението:
+Началният файл за уеб приложенията е `index.php`, разположен в публичната директория `www/`. Той използва класа `Bootstrap` за инициализиране на средата и създаване на контейнер DI. След това получава услугата `Application` от контейнера, която стартира уеб приложението:
 
 ```php
-// инициализиране на средата + получаване на обект Configurator
-$configurator = App\Bootstrap::boot();
-// създаване на DI-контейнер
-$container = $configurator->createContainer();
-// DI-контейнерът ще създаде обект Nette\Application\Application
+$bootstrap = new App\Bootstrap;
+// Иницииране на средата + създаване на контейнер DI
+$container = $bootstrap->bootWebApplication();
+// Контейнерът DI създава обект Nette\Application\Application
 $application = $container->getByType(Nette\Application\Application::class);
-//стартиране на приложението Nette
+// Стартирайте приложението Nette и обработете входящата заявка
 $application->run();
 ```
 
@@ -66,19 +91,19 @@ Nette прави разграничение между два основни р
 Ако искате да активирате режима за разработка в други случаи, например за програмисти, които имат достъп от определен IP адрес, можете да използвате `setDebugMode()`:
 
 ```php
-$configurator->setDebugMode('23.75.345.200'); // един или повече IP адреси
+$this->configurator->setDebugMode('23.75.345.200'); // един или повече IP адреси
 ```
 
 Определено препоръчваме да комбинирате IP адреса с "бисквитка". Ще съхраним тайния токен в "бисквитката" `nette-debug', например, `secret1234`, а режимът за разработка ще бъде активиран за програмистите с тази комбинация от IP и "бисквитка".
 
 ```php
-$configurator->setDebugMode('[email protected]');
+$this->configurator->setDebugMode('[email protected]');
 ```
 
 Можете да деактивирате напълно режима за разработчици, дори за localhost:
 
 ```php
-$configurator->setDebugMode(false);
+$this->configurator->setDebugMode(false);
 ```
 
 Обърнете внимание, че стойността `true` активира плътно режима за разработчици, което никога не трябва да се случва на производствен сървър.
@@ -90,7 +115,7 @@ $configurator->setDebugMode(false);
 За да улесним дебъгването, ще включим чудесния инструмент [Tracy |tracy:]. В режим за разработчици той визуализира грешките, а в производствен режим записва грешките в определена директория:
 
 ```php
-$configurator->enableTracy($appDir . '/log');
+$this->configurator->enableTracy($this->rootDir . '/log');
 ```
 
 
@@ -100,7 +125,7 @@ $configurator->enableTracy($appDir . '/log');
 Nette използва кеш за DI-контейнер, RobotLoader, шаблони и др. Затова е необходимо да се зададе пътят до директорията, в която се съхранява кешът:
 
 ```php
-$configurator->setTempDirectory($appDir . '/temp');
+$this->configurator->setTempDirectory($this->rootDir . '/temp');
 ```
 
 В Linux или macOS задайте [разрешения за запис |nette:troubleshooting#Setting-Directory-Permissions] за директориите `log/` и `temp/`.
@@ -112,7 +137,7 @@ RobotLoader .[#toc-robotloader]
 Обикновено искаме да заредим класовете автоматично с помощта на [RobotLoader |robot-loader:], така че трябва да го стартираме и да му позволим да зареди класовете от директорията, в която се намира `Bootstrap.php` (т.е. `__DIR__`) и всички негови поддиректории:
 
 ```php
-$configurator->createRobotLoader()
+$this->configurator->createRobotLoader()
 	->addDirectory(__DIR__)
 	->register();
 ```
@@ -126,7 +151,7 @@ $configurator->createRobotLoader()
 Конфигураторът ви позволява да зададете часовата зона за вашето приложение.
 
 ```php
-$configurator->setTimeZone('Europe/Prague');
+$this->configurator->setTimeZone('Europe/Prague');
 ```
 
 
@@ -143,16 +168,17 @@ $configurator->setTimeZone('Europe/Prague');
 Файловете за конфигурация се зареждат с помощта на `addConfig()`:
 
 ```php
-$configurator->addConfig($appDir . '/config/common.neon');
+$this->configurator->addConfig($this->rootDir . '/config/common.neon');
 ```
 
 Методът `addConfig()` може да се извика няколко пъти, за да се добавят няколко файла.
 
 ```php
-$configurator->addConfig($appDir . '/config/common.neon');
-$configurator->addConfig($appDir . '/config/local.neon');
+$configDir = $this->rootDir . '/config';
+$this->configurator->addConfig($configDir . '/common.neon');
+$this->configurator->addConfig($configDir . '/services.neon');
 if (PHP_SAPI === 'cli') {
-	$configurator->addConfig($appDir . '/config/cli.php');
+	$this->configurator->addConfig($configDir . '/cli.php');
 }
 ```
 
@@ -169,7 +195,7 @@ if (PHP_SAPI === 'cli') {
 Параметрите, използвани в конфигурационните файлове, могат да бъдат дефинирани [в раздела `parameters` |dependency-injection:configuration#parameters] и да бъдат взети (или презаписани) от метода `addStaticParameters()` (той има псевдоним `addParameters()`). Важно е, че различните стойности на параметрите водят до генериране на допълнителни DI-контейнери, т.е. допълнителни класове.
 
 ```php
-$configurator->addStaticParameters([
+$this->configurator->addStaticParameters([
 	'projectId' => 23,
 ]);
 ```
@@ -183,15 +209,15 @@ $configurator->addStaticParameters([
 Възможно е също така да се добавят динамични параметри към контейнер. Различните им стойности, за разлика от статичните параметри, не генерират нови контейнери DI.
 
 ```php
-$configurator->addDynamicParameters([
+$this->configurator->addDynamicParameters([
 	'remoteIp' => $_SERVER['REMOTE_ADDR'],
 ]);
 ```
 
 Достъпът до променливите на средата е лесен с помощта на динамични параметри. Достъпът до тях се осъществява чрез `%env.variable%` в конфигурационните файлове.
 
 ```php
-$configurator->addDynamicParameters([
+$this->configurator->addDynamicParameters([
 	'env' => getenv(),
 ]);
 ```
@@ -206,6 +232,7 @@ $configurator->addDynamicParameters([
 - `%wwwDir%` е абсолютният път до директорията, съдържаща входния файл `index.php`
 - `%tempDir%` е абсолютният път до директорията за временни файлове
 - `%vendorDir%` е абсолютният път до директорията, в която Composer инсталира библиотеки
+- `%rootDir%` е абсолютният път до главната директория на проекта
 - `%debugMode%` показва дали приложението е в режим на отстраняване на грешки
 - `%consoleMode%` показва дали заявката е постъпила от командния ред
 
@@ -225,7 +252,7 @@ services:
 Създайте нов екземпляр и го вмъкнете в Bootstrap:
 
 ```php
-$configurator->addServices([
+$this->configurator->addServices([
 	'myservice' => new App\Model\MyCustomService('foobar'),
 ]);
 ```
@@ -234,13 +261,21 @@ $configurator->addServices([
 Различни среди .[#toc-different-environments]
 =============================================
 
-Не се колебайте да персонализирате класа `Bootstrap` според нуждите си. Можете да добавите параметри към метода `boot()`, за да разделите уеб проектите, или да добавите други методи, като например `bootForTests()`, който инициализира средата за тестове на единици, `bootForCli()` за скриптове, извикани от командния ред, и т.н.
+Не се колебайте да персонализирате класа `Bootstrap` според нуждите си. Можете да добавите параметри към метода `bootWebApplication()`, за да разграничите отделните уеб проекти. Като алтернатива можете да добавите и други методи, например `bootTestEnvironment()` за инициализиране на средата за unit тестове, `bootConsoleApplication()` за скриптове, извикани от командния ред, и т.н.
 
 ```php
-public static function bootForTests(): Configurator
+public function bootTestEnvironment(): Nette\DI\Container
+{
+	Tester\Environment::setup(); // Инициализация на Nette Tester
+	$this->setupContainer();
+	return $this->configurator->createContainer();
+}
+
+public function bootConsoleApplication(): Nette\DI\Container
 {
-	$configurator = self::boot();
-	Tester\Environment::setup(); // Инициализация Nette Tester
-	return $configurator;
+	$this->configurator->setDebugMode(false);
+	$this->initializeEnvironment();
+	$this->setupContainer();
+	return $this->configurator->createContainer();
 }
 ```

application/bg/components.texy

@@ -230,6 +230,28 @@ $this->redirect(/* ... */); // пренасочване
 ```
 
 
+Пренасочване след сигнал .[#toc-redirection-after-a-signal]
+===========================================================
+
+След обработката на сигнал от компонент често следва пренасочване. Тази ситуация е подобна на формулярите - след изпращане на формуляр също пренасочваме, за да предотвратим повторното изпращане на данни, когато страницата се опреснява в браузъра.
+
+```php
+$this->redirect('this') // redirects to the current presenter and action
+```
+
+Тъй като компонентът е елемент за многократна употреба и обикновено не трябва да има пряка зависимост от конкретни презентатори, методите `redirect()` и `link()` автоматично интерпретират параметъра като сигнал за компонент:
+
+```php
+$this->redirect('click') // redirects to the 'click' signal of the same component
+```
+
+Ако трябва да пренасочите към друг презентатор или действие, можете да го направите чрез презентатора:
+
+```php
+$this->getPresenter()->redirect('Product:show'); // redirects to a different presenter/action
+```
+
+
 Постоянни параметри .[#toc-persistent-parameters]
 =================================================
 
@@ -347,7 +369,7 @@ services:
 Накрая ще използваме тази фабрика в нашия презентатор:
 
 ```php
-class PollPresenter extends Nette\UI\Application\Presenter
+class PollPresenter extends Nette\Application\UI\Presenter
 {
 	public function __construct(
 		private PollControlFactory $pollControlFactory,
@@ -380,7 +402,7 @@ interface PollControlFactory
 Компонентите в Nette Application са части за многократна употреба на уеб приложение, които вграждаме в страници, което е предмет на тази глава. Какви са възможностите на такъв компонент?
 
 1) може да се показва в шаблон
-2) той знае каква част от себе си да покаже по време на [заявката AJAX |ajax#invalidation] (фрагменти)
+2) знае [коя част от себе си |ajax#snippets] да визуализира по време на заявка AJAX (фрагменти).
 3) има възможност да съхранява състоянието си в URL (постоянни параметри).
 4) има възможност да реагира на действията (сигналите) на потребителя.
 5) създава йерархична структура (където коренът е главният).