README

The Drago Extension is a package built on top of the Nette Framework, designed to provide several useful components for your web applications. Below are the classes in the extension and how you can use them.

Requirements

• PHP >= 8.3
• Nette Framework
• Composer
• Bootstrap
• Naja

Installation

composer require drago-ex/application

Project files

File copying is handled automatically by drago-ex/project-tools, which must be installed in your project. Without it, copy the files manually according to the copy section in this package's composer.json. To skip this package, set "skip": true under extra.drago-tools.packages.<package-name> in your root composer.json.

Check if there is a pair signal receiver and name (default is edit).

$this->getSignal();

Is AJAX request?

Shorter method in control.

$this->isAjax();

Retrieves a form component by its name.

$form = $this['factory'];
$submitButton = $this->getFormComponent($form, 'submit');
$submitButton->setCaption('Edit');

Form factory with a custom form class

Use Drago\Application\UI\Factory when you want a typed factory for another form class, for example ExtraForms from drago-ex/form.

use Drago\Form\ExtraForms;

/**
 * @extends \Drago\Application\UI\Factory<ExtraForms>
 */
readonly class Factory extends \Drago\Application\UI\Factory
{
	protected function createForm(): ExtraForms
	{
		return new ExtraForms;
	}
}

Base template class extending Nette Template.

Use it in presenter or control PHPDoc:

/**
 * @property-read Drago\Application\UI\ExtraTemplate $template
 */
class Presenter {}

In Latte, we will use these macros to insert into the template, which will tell us the variables and types that can be used by default in the template.

{templateType Drago\Application\UI\ExtraTemplate}
{varType Drago\Application\UI\Flashes[] $flashes}

{include 'path/to/@flash-message.latte', flashes: $flashes}

Flash message alert type

• Alert

Toast - Bootstrap and Naja component for flash messages

JavaScript setup

Since the package is installed via Composer, add the following to your package.json:

{
  "type": "module",
  "dependencies": {
    "drago-application": "file:vendor/drago-ex/application"
  }
}

Then run npm install.

import ToastHandler from 'drago-application/bootstrap-toast';

Using toast in a Latte template

{include 'path/to/@toast.latte', flashes: $flashes}