Warning: You are browsing the documentation from version 4 to 10 of Pimcore. Please visit https://pimcore.com/docs/platform/ for the latest versions of Pimcore.

Version:

Link Editable

General

The link editable is used for dynamic link creation in documents.

Configuration

You can pass every valid attribute an <a>-tag can have (w3.org - Link), such as: class, target, id, style, accesskey, name, title and additionally the following:

Name	Type	Description
`reload`	boolean	Set to true to reload the page in editmode after changing the state.
`textPrefix`	string	Add an icon or something else before Text
`textSuffix`	string	Add an icon or something else after Text
`noText`	boolean	If you need only the tag without text (or only with an textSuffix/TextPrefix)

Methods

Name	Return	Description
`getHref()`	string	Get the path of this link
`getText()`	string	Get the text of the link
`getTarget()`	string	Get the target of the link
`getParameters()`	string	Get the query params of the link
`getAnchor()`	string	Get the anchor text of the link
`getTitle()`	string	Get the title of the link
`getRel()`	string	Get the rel text of the link
`getTabindex()`	string	Get the tabindex of the link
`getClass()`	string	Get the class of the link
`getAccessKey()`	string	Get the access key of the link
`isEmpty()`	string	Whether the editable is empty or not

Examples

Basic Usage

<p>
    <?= $this->translate("Visit our"); ?> 
    <?= $this->link("blogLink"); ?>
</p>

<p>
    {{ "Visit our" | trans }}
    {{ pimcore_link('blogLink') }}
</p>

You could see the backend preview in the picture, below.

Link editable - adminitration panel

And the frontend:

Link editable - frontend

Use Link in the Block Editable

Let's see how to make a list of links with Block.

<h3><?= $this->translate("Useful links"); ?></h3>
<ul>
    <?php while ($this->block("linkblock")->loop()): ?>
        <li>
            <?= $this->link("myLink", ["class" => "special-link-class"]); ?>
        </li>
    <?php endwhile; ?>
</ul>

<h3>{{ "Useful links" | trans }}</h3>
<ul>
    {% for i in pimcore_iterate_block(pimcore_block('linkblock')) %}
        <li>{{ pimcore_link('myLink', {'class': "special-link-class"}) }}</li>
    {% endfor %}
</ul>

The above example renders a list of links: The links list in the backend

Link Generators

Please also see the section about Link Generators