Defined Links

Add a link to the text by selecting it from a predefined list in the link popup.

<h1>Exploring the mysteries of space</h1>
<p>Space, the final frontier, stretches infinitely beyond the confines of Earth, a vast expanse of darkness speckled with stars, planets, and <b>galaxies</b>. It is a place of profound mystery and beauty, where the laws of physics manifest in ways that challenge our understanding. The cosmos is <a href="https://example/com">a cosmic dance</a> of celestial bodies moving in the silent echo of the universe, from the fiery birth of stars in nebulae to the enigmatic pull of black holes.</p>
<figure>
  <img src="/assets/img/redactor4-photo.jpg" alt="Blue and purple galaxy">
  <figcaption>Jeremy Thomas <a href="https://unsplash.com/photos/blue-and-purple-galaxy-digital-wallpaper-E0AHdsENmDg">unsplash.com</a></figcaption>
</figure>
<h2>Humanity's Journey Beyond Earth</h2>
<p>Exploring space has pushed humanity to its limits, revealing not just the universe's grandeur, but also the fragility of our own planet. Satellites orbiting Earth provide crucial data for communication, weather forecasting, and global positioning, while telescopes peer deep into the cosmos, uncovering the universe's age and composition. Each discovery in space leads us to new questions about our place in the universe, driving our insatiable curiosity to explore the unknown.</p>

Code

<!DOCTYPE html>
<html>
    <head>
        <title>Redactor</title>
        <meta charset="utf-8">

        <!-- css -->
        <link rel="stylesheet" href="/your-folder/redactor.css" />
    </head>
    <body>
        <!-- element -->
        <textarea id="entry">...</textarea>

        <!-- js -->
        <script src="/your-folder/redactor.js"></script>
        <script src="/your-folder/plugins/definedlinks/definedlinks.js"></script>

        <!-- call -->
        <script>
        Redactor('#entry', {
            plugins: ['definedlinks'],
            definedlinks: {
                items: [
                    { "name": "Select...", "url": false },
                    { "name": "Google", "url": "http://google.com" },
                    { "name": "Home", "url": "/" },
                    { "name": "About", "url": "/about/" },
                    { "name": "Contact", "url": "/contact/" }
                ]
            }
        });
        </script>
    </body>
</html>

Usage

url

The plugin can accept a url parameter:


Redactor('#entry', {
    plugins: ['definedlinks'],
    definedlinks: {
        url: 'my-path-to-the-server'
    }
});

For example, you can generate a dynamic link list for a plugin on server-side and return it as a JSON object:


$items = [
    [ "name" => "Select from dymanic...", "url" => false ],
    [ "name" => "Google", "url" => "http://google.com" ],
    [ "name" => "Home", "url"  => "/" ],
    [ "name" => "About", "url" => "/about/" ],
    [ "name" => "Contact", "url"  => "/contact/" ]
];

echo json_encode($items);

function

The plugin can accept a function for the items parameter:


Redactor('#entry', {
    plugins: ['definedlinks'],
    definedlinks: {
        items: function() {
            const obj = [
                { "name": "Select from function...", "url": '' },
                { "name": "Google", "url": "http://google.com" },
                { "name": "Home", "url": "/" },
                { "name": "About", "url": "/about/" },
                { "name": "Contact", "url": "/contact/" }
            ];
            return obj;
        }
    }
});

So in a custom function you can dynamically generate a list of links or fetch them from the server using javascript.