Δημιουργία συνδέσμων URL
************************

<div class=perex>

Η δημιουργία συνδέσμων στη Nette είναι τόσο εύκολη όσο το να δείξετε με το δάχτυλο. Απλά δείξτε και το πλαίσιο θα κάνει όλη τη δουλειά για εσάς. Θα σας δείξουμε:

- πώς να δημιουργείτε συνδέσμους σε πρότυπα και αλλού
- πώς να διακρίνετε έναν σύνδεσμο στην τρέχουσα σελίδα
- τι γίνεται με τους άκυρους συνδέσμους

</div>


Χάρη στην [αμφίδρομη δρομολόγηση |routing], δεν θα χρειαστεί ποτέ να κωδικοποιήσετε σκληρά τις διευθύνσεις URL της εφαρμογής στα πρότυπα ή στον κώδικα, οι οποίες μπορεί να αλλάξουν αργότερα ή να είναι περίπλοκες στη σύνταξη. Απλώς καθορίστε τον παρουσιαστή και την ενέργεια στο σύνδεσμο, περάστε τυχόν παραμέτρους και το πλαίσιο θα δημιουργήσει μόνο του τη διεύθυνση URL. Στην πραγματικότητα, μοιάζει πολύ με την κλήση μιας συνάρτησης. Θα σας αρέσει.


Στο πρότυπο παρουσιαστή .[#toc-in-the-presenter-template]
=========================================================

Τις περισσότερες φορές δημιουργούμε συνδέσμους σε πρότυπα και ένας μεγάλος βοηθός είναι το χαρακτηριστικό `n:href`:

```latte
<a n:href="Product:show">detail</a>
```

Σημειώστε, ότι αντί για το χαρακτηριστικό HTML `href` χρησιμοποιήσαμε το [n:attribute |latte:syntax#n:attributes] `n:href`. Η τιμή του δεν είναι ένα URL, όπως έχετε συνηθίσει με το χαρακτηριστικό `href`, αλλά το όνομα του παρουσιαστή και της ενέργειας.

Το κλικ σε έναν σύνδεσμο είναι, απλά ειπωμένο, κάτι σαν την κλήση μιας μεθόδου `ProductPresenter::renderShow()`. Και αν αυτή έχει παραμέτρους στην υπογραφή της, μπορούμε να την καλέσουμε με ορίσματα:

```latte
<a n:href="Product:show $product->id, $product->slug">detail</a>
```

Είναι επίσης δυνατό να περάσουμε ονομαστικές παραμέτρους. Ο ακόλουθος σύνδεσμος περνάει την παράμετρο `lang` με την τιμή `en`:

```latte
<a n:href="Product:show $product->id, lang: en">detail</a>
```

Εάν η μέθοδος `ProductPresenter::renderShow()` δεν έχει στην υπογραφή της την `$lang`, μπορεί να ανακτήσει την τιμή της παραμέτρου χρησιμοποιώντας την `$lang = $this->getParameter('lang')` ή από την [ιδιότητα |presenters#Request Parameters].

Εάν οι παράμετροι είναι αποθηκευμένες σε πίνακα, μπορούν να επεκταθούν με τον τελεστή `...` (ή `(expand)` στο Latte 2.x):

```latte
{var $args = [$product->id, lang => en]}
<a n:href="Product:show ...$args">detail</a>
```

Οι λεγόμενες [μόνιμες παράμετροι |presenters#persistent parameters] περνούν επίσης αυτόματα στους συνδέσμους.

Το χαρακτηριστικό `n:href` είναι πολύ χρήσιμο για τις ετικέτες HTML `<a>`. Αν θέλουμε να εκτυπώσουμε τον σύνδεσμο αλλού, για παράδειγμα στο κείμενο, χρησιμοποιούμε το `{link}`:

```latte
URL is: {link Home:default}
```


Στον κώδικα .[#toc-in-the-code]
===============================

Η μέθοδος `link()` χρησιμοποιείται για τη δημιουργία ενός συνδέσμου στον παρουσιαστή:

```php
$url = $this->link('Product:show', $product->id);
```

Οι παράμετροι μπορούν επίσης να μεταβιβαστούν ως πίνακας όπου μπορούν επίσης να καθοριστούν ονομαστικές παράμετροι:

```php
$url = $this->link('Product:show', [$product->id, 'lang' => 'cs']);
```

Οι σύνδεσμοι μπορούν να δημιουργηθούν και χωρίς παρουσιαστή, χρησιμοποιώντας το [LinkGenerator |#LinkGenerator] και τη μέθοδο `link()`.


Σύνδεσμοι με παρουσιαστή .[#toc-links-to-presenter]
===================================================

Εάν ο στόχος του συνδέσμου είναι παρουσιαστής και δράση, έχει την εξής σύνταξη:

```
[//] [[[[:]module:]presenter:]action | this] [#fragment]
```

Η μορφή υποστηρίζεται από όλες τις ετικέτες Latte και όλες τις μεθόδους παρουσιαστή που λειτουργούν με συνδέσμους, δηλαδή `n:href`, `{link}`, `{plink}`, `link()`, `lazyLink()`, `isLinkCurrent()`, `redirect()`, `redirectPermanent()`, `forward()`, `canonicalize()` και επίσης [LinkGenerator |#LinkGenerator]. Έτσι, ακόμη και αν στα παραδείγματα χρησιμοποιείται η `n:href`, θα μπορούσε να υπάρχει οποιαδήποτε από τις συναρτήσεις.

Η βασική μορφή είναι επομένως `Presenter:action`:

```latte
<a n:href="Home:default">home</a>
```

Αν συνδεθούμε με τη δράση του τρέχοντος παρουσιαστή, μπορούμε να παραλείψουμε το όνομά του:

```latte
<a n:href="default">home</a>
```

Αν η ενέργεια είναι `default`, μπορούμε να την παραλείψουμε, αλλά η άνω και κάτω τελεία πρέπει να παραμείνει:

```latte
<a n:href="Home:">home</a>
```

Οι σύνδεσμοι μπορούν επίσης να παραπέμπουν σε άλλες [ενότητες |modules]. Εδώ, οι σύνδεσμοι διακρίνονται σε σχετικούς με τις υποενότητες ή απόλυτους. Η αρχή είναι ανάλογη με τις διαδρομές δίσκου, μόνο που αντί για κάθετους υπάρχουν άνω και κάτω τελεία. Ας υποθέσουμε ότι ο πραγματικός παρουσιαστής είναι μέρος της ενότητας `Front`, τότε θα γράψουμε:

```latte
<a n:href="Shop:Product:show">link to Front:Shop:Product:show</a>
<a n:href=":Admin:Product:show">link to Admin:Product:show</a>
```

Μια ειδική περίπτωση είναι η [σύνδεση με τον εαυτό της |#Links to Current Page]. Εδώ θα γράψουμε `this` ως στόχο.

```latte
<a n:href="this">refresh</a>
```

Μπορούμε να συνδεθούμε σε ένα συγκεκριμένο τμήμα της σελίδας HTML μέσω ενός λεγόμενου αποσπάσματος μετά το σύμβολο κατακερματισμού `#`:

```latte
<a n:href="Home:#main">link to Home:default and fragment #main</a>
```


Απόλυτες διαδρομές .[#toc-absolute-paths]
=========================================

Οι σύνδεσμοι που δημιουργούνται από το `link()` ή το `n:href` είναι πάντα απόλυτες διαδρομές (δηλ. ξεκινούν με `/`), αλλά όχι απόλυτες διευθύνσεις URL με πρωτόκολλο και τομέα όπως `https://domain`.

Για να δημιουργήσετε μια απόλυτη διεύθυνση URL, προσθέστε δύο κάθετους στην αρχή (π.χ. `n:href="//Home:"`). Ή μπορείτε να αλλάξετε τον παρουσιαστή ώστε να παράγει μόνο απόλυτους συνδέσμους, ρυθμίζοντας το `$this->absoluteUrls = true`.


Σύνδεσμος προς την τρέχουσα σελίδα .[#toc-link-to-current-page]
===============================================================

Ο στόχος `this` θα δημιουργήσει έναν σύνδεσμο προς την τρέχουσα σελίδα:

```latte
<a n:href="this">refresh</a>
```

Ταυτόχρονα, όλες οι παράμετροι που καθορίζονται στην υπογραφή της `action<Action>()` ή `render<View>()` μεθόδου, εάν η `action<Action>()` δεν έχει οριστεί, μεταφέρονται. Έτσι, αν βρισκόμαστε στις σελίδες `Product:show` και `id:123`, ο σύνδεσμος προς την `this` θα μεταφέρει και αυτή την παράμετρο.

Φυσικά, είναι δυνατόν να καθορίσετε τις παραμέτρους απευθείας:

```latte
<a n:href="this refresh: 1">refresh</a>
```

Η συνάρτηση `isLinkCurrent()` καθορίζει αν ο στόχος του συνδέσμου είναι ο ίδιος με την τρέχουσα σελίδα. Αυτό μπορεί να χρησιμοποιηθεί, για παράδειγμα, σε ένα πρότυπο για τη διαφοροποίηση των συνδέσμων κ.λπ.

Οι παράμετροι είναι οι ίδιες με αυτές της μεθόδου `link()`, αλλά είναι επίσης δυνατό να χρησιμοποιηθεί το μπαλαντέρ `*` αντί για μια συγκεκριμένη ενέργεια, που σημαίνει οποιαδήποτε ενέργεια του παρουσιαστή.

```latte
{if !isLinkCurrent('Admin:login')}
	<a n:href="Admin:login">Přihlaste se</a>
{/if}

<li n:class="isLinkCurrent('Product:*') ? active">
	<a n:href="Product:">...</a>
</li>
```

Μια συντομευμένη μορφή μπορεί να χρησιμοποιηθεί σε συνδυασμό με το `n:href` σε ένα μόνο στοιχείο:

```latte
<a n:class="isLinkCurrent() ? active" n:href="Product:detail">...</a>
```

Ο χαρακτήρας μπαλαντέρ `*` αντικαθιστά μόνο τη δράση του παρουσιαστή, όχι τον ίδιο τον παρουσιαστή.

Για να μάθουμε αν βρισκόμαστε σε μια συγκεκριμένη ενότητα ή υποενότητά της μπορούμε να χρησιμοποιήσουμε τη συνάρτηση `isModuleCurrent(moduleName)`.

```latte
<li n:class="isModuleCurrent('MyEshop:Users') ? active">
	<a n:href="Product:">...</a>
</li>
```


Σύνδεσμοι προς το Signal .[#toc-links-to-signal]
================================================

Ο στόχος του συνδέσμου μπορεί να είναι όχι μόνο ο παρουσιαστής και η ενέργεια, αλλά και το [σήμα |components#Signal] (καλούν τη μέθοδο `handle<Signal>()`). Η σύνταξη έχει ως εξής:

```
[//] [sub-component:]signal! [#fragment]
```

Το σήμα διακρίνεται επομένως με θαυμαστικό:

```latte
<a n:href="click!">signal</a>
```

Μπορείτε επίσης να δημιουργήσετε έναν σύνδεσμο προς το σήμα του υποστοιχείου (ή υπο-υποστοιχείου):

```latte
<a n:href="componentName:click!">signal</a>
```


Σύνδεσμοι στο συστατικό .[#toc-links-in-component]
==================================================

Επειδή [τα συστατικά |components] είναι ξεχωριστές επαναχρησιμοποιήσιμες μονάδες που δεν πρέπει να έχουν καμία σχέση με τους περιβάλλοντες παρουσιαστές, οι σύνδεσμοι λειτουργούν λίγο διαφορετικά. Το χαρακτηριστικό Latte `n:href` και η ετικέτα `{link}` και οι μέθοδοι συστατικών όπως η `link()` και άλλες θεωρούν πάντα τον στόχο **ως το όνομα του σήματος**. Επομένως, δεν είναι απαραίτητο να χρησιμοποιείται θαυμαστικό:

```latte
<a n:href="click">signal, not an action</a>
```

Αν θέλουμε να συνδέσουμε με παρουσιαστές στο πρότυπο συστατικού, χρησιμοποιούμε την ετικέτα `{plink}`:

```latte
<a href={plink Home:default}>home</a>
```

ή στον κώδικα

```php
$this->getPresenter()->link('Home:default')
```


Ψευδώνυμα .[#toc-aliases]{data-version:v3.2.2}
==============================================

Μερικές φορές είναι χρήσιμο να αντιστοιχίσετε ένα εύκολα απομνημονεύσιμο ψευδώνυμο σε ένα ζεύγος Παρουσιαστής:ενέργεια. Για παράδειγμα, θα μπορούσατε να ονομάσετε την αρχική σελίδα `Front:Home:default` απλά ως `home` ή `Admin:Dashboard:default` ως `admin`.

Τα ψευδώνυμα ορίζονται στη [ρύθμιση παρα |configuration] μέτρων κάτω από το κλειδί `application › aliases`:

```neon
application:
    aliases:
        home: Front:Home:default
        admin: Admin:Dashboard:default
        sign: Front:Sign:in
```

Στους συνδέσμους, γράφονται χρησιμοποιώντας το σύμβολο at, για παράδειγμα:

```latte
<a n:href="@admin">administration</a>
```

Υποστηρίζονται σε όλες τις μεθόδους που λειτουργούν με συνδέσμους, όπως το `redirect()` και παρόμοια.


Άκυροι σύνδεσμοι .[#toc-invalid-links]
======================================

Μπορεί να συμβεί να δημιουργήσουμε έναν άκυρο σύνδεσμο - είτε επειδή αναφέρεται σε έναν μη υπάρχοντα παρουσιαστή, είτε επειδή περνάει περισσότερες παραμέτρους από αυτές που λαμβάνει η μέθοδος-στόχος στην υπογραφή της, είτε όταν δεν μπορεί να δημιουργηθεί URL για τη στοχευόμενη ενέργεια. Το τι πρέπει να γίνει με τους άκυρους συνδέσμους καθορίζεται από τη στατική μεταβλητή `Presenter::$invalidLinkMode`. Μπορεί να έχει μία από αυτές τις τιμές (σταθερές):

- `Presenter::InvalidLinkSilent` - σιωπηλή λειτουργία, επιστρέφει το σύμβολο `#` ως διεύθυνση URL
- `Presenter::InvalidLinkWarning` - θα παραχθεί E_USER_WARNING
- `Presenter::InvalidLinkTextual` - οπτική προειδοποίηση, το κείμενο σφάλματος εμφανίζεται στο σύνδεσμο
- `Presenter::InvalidLinkException` - θα εκπέμπεται η εξαίρεση InvalidLinkException

Η προεπιλεγμένη ρύθμιση σε κατάσταση παραγωγής είναι `InvalidLinkWarning` και σε κατάσταση ανάπτυξης είναι `InvalidLinkWarning | InvalidLinkTextual`. Το `InvalidLinkWarning` δεν τερματίζει το σενάριο στο περιβάλλον παραγωγής, αλλά η προειδοποίηση θα καταγραφεί. Στο περιβάλλον ανάπτυξης, το [Tracy |tracy:] θα αναχαιτίσει την προειδοποίηση και θα εμφανίσει την μπλε οθόνη σφάλματος. Εάν έχει οριστεί το `InvalidLinkTextual`, ο παρουσιαστής και τα στοιχεία επιστρέφουν μήνυμα σφάλματος ως URL που ξεκινά με το `#error:`. Για να κάνουμε τέτοιους συνδέσμους ορατούς, μπορούμε να προσθέσουμε έναν κανόνα CSS στο φύλλο στυλ μας:

```css
a[href^="#error:"] {
	background: red;
	color: white;
}
```

Αν δεν θέλουμε να παράγονται προειδοποιήσεις στο περιβάλλον ανάπτυξης, μπορούμε να ενεργοποιήσουμε τη λειτουργία silent invalid link mode στη [ρύθμιση παραμέτρων |configuration].

```neon
application:
	silentLinks: true
```


LinkGenerator .[#toc-linkgenerator]
===================================

Πώς να δημιουργήσετε συνδέσμους με τη μέθοδο `link()` comfort, αλλά χωρίς την παρουσία ενός παρουσιαστή; Γι' αυτό υπάρχει εδώ το [api:Nette\Application\LinkGenerator].

LinkGenerator είναι μια υπηρεσία που μπορείτε να έχετε περάσει μέσω του κατασκευαστή και στη συνέχεια να δημιουργήσετε συνδέσμους χρησιμοποιώντας τη μέθοδό του `link()`.

Υπάρχει μια διαφορά σε σχέση με τους παρουσιαστές. Το LinkGenerator δημιουργεί όλους τους συνδέσμους ως απόλυτες διευθύνσεις URL. Επιπλέον, δεν υπάρχει "τρέχων παρουσιαστής", οπότε δεν είναι δυνατόν να καθορίσετε μόνο το όνομα της ενέργειας `link('default')` ή τις σχετικές διαδρομές προς τις [ενότητες |modules].

Οι άκυροι σύνδεσμοι πάντα προκαλούν `Nette\Application\UI\InvalidLinkException`.