JoomUnited Linky Map - Joomla Extension

Guide to Setting Up and Using JoomUnited Linky Map

JoomUnited Linky Map is better thought of not as a simple image with clickable dots, but as a tool for interactive maps in Joomla: regional maps, markers, tooltips, HTML descriptions, and display through a menu item, module, or article. This guide explains how to prepare your site, install the extension safely, build a map for a real use case, place it on a page, and verify the result without guesswork.

This article does not repeat the product's short description. The practical logic matters more here: what data to prepare in advance, which map type to choose, how to configure colors and click behavior, where problems usually appear, why a map may fail to show on the site, and when a different solution makes more sense.

You will see diagrams throughout this guide. They are not actual interface screenshots. Instead, they illustrate the working logic behind setup and validation: the Joomla admin panel, the map itself, the user-facing result, and the typical places where troubleshooting happens.

How the Interactive Map Workflow Works

Linky Map's strength is that the map is built from several layers: the geographic base itself, regions or markers, click actions, tooltips, the description shown next to the map, and the publishing method. If you skip one layer, the result can feel incomplete: the map is there, but the user does not know where to click; the markers are in place, but do not lead to the right pages; the module is published, but visible on the wrong menu items.

JoomUnited's official materials describe two main directions: maps based on Google GeoChart and custom maps based on jQuery vector map. For a site owner, that means a practical choice: use ready-made geographic regions, or upload your own SVG map if you need a shopping mall layout, facility plan, hall layout, campus map, or any other structure that does not resemble a standard country map.

In Joomla, the extension works as a set of connected parts. The component is used to create and configure maps. The module helps display the map in a selected template position. The content plugin and editor button let you insert the map into an article. This setup is convenient, but it requires discipline: the map must be created in the component, while the display location is selected separately. Beginners often mix up these steps and look for an error where the real issue is simply that the map was never assigned to the right page.

Before you begin, it helps to picture the process like this:

1. You choose the map type: regions, markers, or a custom SVG base.
2. You add the data: names, region codes, addresses, coordinates, links, HTML descriptions.
3. You configure the appearance: colors, highlighting, tooltips, click behavior, zooming.
4. You publish the map through a menu item, module, or article embed.
5. You check the front end, access permissions, cache, responsiveness, and link behavior.

This sequence matters throughout the entire guide. Linky Map will not solve the problem by itself if the source data is chaotic. But with proper preparation, it can replace a long list of addresses, offices, or regions with visual navigation that answers the user's question faster: "where should I go next?"

Where Linky Map Is Most Useful and Where a Map Is Unnecessary

An interactive map is not right for every page. If a site has one office, one pickup point, or a short list of countries, a standard address block may be enough. Linky Map becomes valuable when the user has a choice to make: a region, city, service area, branch, store location, office, delivery zone, local partner, or a geography-based section of the site.

On Joomla sites, this is especially noticeable in projects with a diverse structure. For example, a manufacturer can show delivery regions, an educational center can show branches, a travel portal can show destinations, an association can show local chapters, a municipal website can show districts, and an internal corporate portal can show a building layout or responsibility zones. In those cases, the map is not decoration. It works as a navigation layer.

A Regional Map for a Territory Catalog

A regional map works well when the user is choosing a state, country, province, or another administrative area. In Google GeoChart, regions are defined through codes and can be color-coded based on data. That is useful if you need to highlight coverage areas, service statuses, branch types, or service availability.

The workflow looks like this: you prepare a list of regions, assign each one a clear name, color, link, or description, and then display the map on a "Where We Operate" page. The user clicks a region and is taken to a local page, a modal window, or an HTML block with an explanation.

Markers for Locations, Offices, and Branches

A marker-based map is a better fit for individual locations. Here, the goal is not to color an entire country, but to show specific places. Linky Map documentation describes marker maps that can work with geographic coordinates or an address. This mode is best for offices, dealers, warehouses, real estate listings, and tourist destinations.

The main risk with a marker map is inaccurate data. If an address is entered in free form and geocoding interprets it differently, the point may end up in the wrong city or on the wrong street. For production sites, it is better to prepare coordinates in advance and manually verify several markers after publishing.

A Custom SVG Map for a Non-Standard Layout

A custom map is needed when the geography is conceptual: a shopping mall plan, exhibition hall, campus, service zones inside a facility, room map, or logistics layout. In that case, standard countries and regions are not a fit. According to the official documentation, Linky Map can work with a custom SVG map and connect areas to data.

This type of setup requires more preparation. The SVG needs to be structured cleanly, the zones need clear identifiers, and the editor needs to understand which zone matches which description. But the result can be far more useful than a static image: the user clicks a zone and immediately sees the department, floor, route, link, or description.

Who This Extension Fits and Who Should Start with Another Tool

JoomUnited Linky Map is a strong fit for webmasters and editors who need a manageable map inside Joomla without developing a custom JavaScript component. The user gets a visual structure, while the administrator keeps control over the display through familiar CMS mechanisms: menus, module positions, and articles.

The extension is a good choice if you need to:

• Build a map of countries, regions, or states with interactive tooltips and links.
• Display a map of offices, partners, branches, or representatives on a Joomla page.
• Reuse the same map in multiple places across the site through a module or article embed.
• Create your own SVG map for a room layout, shopping mall, or facility plan.
• Give a content editor a tool that does not require constant template code edits.

But there are cases where Linky Map is not the best starting point. If you need full route planning, directions, road layers, a complex address database, filtering by dozens of parameters, or deep integration with Google Maps as a mapping service, you should compare it with location directory solutions. JoomUnited itself offers My Maps Location for a different use case, and the Joomla ecosystem includes extensions aimed at classic place-based maps.

Another important point is the source of the map. Linky Map depends on the visual representation and data you prepare. If the project has no solid region structure, no accurate addresses, or the custom SVG layout was drawn without clear zones, the extension will not fix that automatically. The quality of an interactive map starts with the quality of the data, not with the highlight color you choose.

Practical check: before installation, write down one user question the map should answer. For example: "Which region has a service center?", "Where is the nearest office?", or "Which building section handles this service?" If you cannot formulate the question, the map may end up being purely decorative.

What to Prepare Before Installing in Joomla

Preparation saves more time than it may seem. The extension can be installed quickly, but small issues often surface afterward: the editor does not know which regions are needed, links point to unfinished pages, the map is displayed in a module but the module is not assigned to a menu item, or the custom SVG layout has no meaningful area identifiers.

For a standard site, prepare three groups of data: geography, content, and publishing location. Geography answers the question "what will be clickable"; content answers "what will the user see after clicking"; and publishing location answers "where will the map live on the site."

Data for a Regional Map

For a regional map, you need a list of countries, regions, or states. Not just the name, but also the region code matters. Google GeoChart uses its own region references, and an incorrect code can cause an area not to highlight. If you are unsure about the code, create a test map with 2-3 regions first instead of loading the entire list at once.

A good minimum set for each region includes:

• The region name for the administrator and the tooltip.
• The region code or geographic reference expected by the selected map mode.
• A color or status if the map shows differences between regions.
• A link to the region page, contact page, dealer page, or service page.
• A short description for a side HTML block or modal window.

Data for Markers

For markers, decide right away what the primary source should be: an address or coordinates. An address is more convenient for an editor, but coordinates are more reliable for exact positioning. If the map is tied to sales, delivery, medical facilities, or branch offices, do not rely only on a nice label. Check the point on a public map and make sure it represents the correct location.

If you use addresses, keep the format consistent: country, city, street, building number, additional information. If you use coordinates, store them separately in an import table or content plan so the editor does not lose the original values.

Data for a Custom SVG Map

A custom SVG map requires especially careful preparation. The vector layout should not just look good. It should be editable: the zones the user will click must be separate objects. If the designer delivered the SVG as a set of decorative lines without clear identifiers, configuration will turn into manual area hunting.

For this type of map, ask the designer in advance, or prepare yourself:

• Separate areas for all clickable zones.
• Clear zone identifiers without spaces or random symbols.
• A consistent scale with no unnecessary invisible layers.
• A test version with several zones so you can verify behavior before full rollout.

Access Permissions, Cache, and Template

In Joomla, it is important to check in advance who will manage the map and where it will be visible. If a content manager will configure the map, they may need access to the component, module, or articles. If the map appears on a public page, it must be available to the correct user group. If site cache or aggressive JavaScript optimization is enabled, it may look as though settings were not applied after edits.

The template also affects the result. A narrow content column, hidden overflow, conflicting styles, or a module position with fixed width can ruin the map even if the configuration itself is correct. That is why it is better to choose a test page before installation, where you can verify the map calmly without the influence of a complex homepage layout.

Installation and Initial Verification Without Extra Risk

Installing a Joomla extension is usually done through the system's extension manager. The exact path depends on the interface in your Joomla version, but the logic stays the same: upload the installation package, make sure the component, module, and plugins appear in the system, then enable the required parts and verify a test map. Do not treat installation as a single action. With Linky Map, it is more important to confirm that all working elements were installed.

Work on a test page or a site copy first. An interactive map uses scripts, styles, the external Google Charts library for relevant modes, and output in the template. Even if the extension installs without errors, conflicts with cache, optimization, module position, or script loading policy may still appear on a specific page.

Basic Installation Order

1. Create a site backup, or at least export your settings, if you are working on an active project.
2. Install the extension package through Joomla's extension manager.
3. Verify that the Linky Map component appears in the admin panel.
4. Find the related modules and plugins required to display the map.
5. Create a simple test map with one region or one marker.
6. Display it on a private or draft page and check the site front end.

At this stage, do not import every branch office or the entire SVG layout yet. First confirm that the map appears, scripts load, tooltips open, and links work. If the basic map does not display, a full data set will only make troubleshooting harder.

What to Check After Installation

After installation, do not only check whether the component menu item exists. Go through several points:

• The component opens in the admin panel without errors and lets you create a new map.
• The Linky Map module is available in the module list if you plan to display the map through a template position.
• The content plugin is enabled if you plan to insert the map into an article through special syntax or the editor button.
• The test map appears on a public page for a guest user if it is meant to be public.
• Clicking a region or marker performs the expected action: opens a link, tooltip, modal window, or HTML description.

If the map does not appear at this point, do not change every setting at once. Check the display location, module status, menu assignment, plugin activation, and cache. In most cases, the initial problem is not the map data itself, but the fact that Joomla is not rendering the correct module or processing the article embed.

Configuring the Map: Regions, Markers, Colors, and Click Behavior

Detailed configuration begins with choosing the map type. This is not just a formality. A regional map, a marker map, and a custom SVG map answer the user's question in different ways. If you choose the wrong mode, you will end up working around limitations later, trying to show branches through region colors or turning a shopping mall layout into a set of generic markers.

In the Linky Map admin panel, create the map as a separate entity and give it a clear internal name. For editors, it helps to include the purpose in the name, not just the geography: "Delivery Regions Map," "Branches by City," or "Pavilion Layout." This reduces the risk that a module will accidentally load the wrong map.

Choosing the Map Base

For Google GeoChart modes, follow Google's official documentation: regional maps work well for countries, continents, and administrative territories, while markers are better for points. In Linky Map, this becomes a practical interface choice: you either work with a list of regions, a set of points, or your own SVG base.

A typical selection logic looks like this:

If you are unsure, build a quick prototype. One map with three regions or two markers will show more than a long discussion. A prototype is especially useful if the map will be maintained by content managers rather than developers.

Colors, Highlighting, and Visual Hierarchy

Colors should help users read the map, not simply match the brand palette. For regions, choose a limited number of states, such as active regions, upcoming regions, and unavailable regions. If every region has its own color without a clear legend, users will not understand what the map means.

The same principle applies to markers: do not overload the map with dozens of identical points without grouping. If there are many objects, consider whether Linky Map is really the right tool or whether an extension with location filtering would work better. If there are only a few, make the markers clearly visible and keep the tooltips short.

How to Verify the Color Setup

After saving the settings, open the map page in a normal user view. Check three states: default view, hover, and click. The colors should differ enough for the user to recognize interactivity. If hover does not work on mobile the way it does on desktop, the tap action should still be clear through text next to the map or the tooltip itself.

Tooltips, HTML Sidebar, and Modal Window

The official product page mentions HTML in the sidebar and modal. This matters because the map alone is often not enough. The user clicks a region, but still needs to understand what comes next: go to a regional office page, view an address, open a service list, or read a short explanation.

A good tooltip is short. A sidebar or modal window can be longer, but do not turn it into a second page. A practical structure looks like this:

• The name of the region or location.
• One line for status or purpose.
• A short description, if needed.
• One primary link for the next action.

If the HTML description includes images, tables, or complex blocks, test responsiveness separately. A popup that looks good on a wide screen may become awkward in a narrow column.

What Not to Enable Without a Reason

Some settings may look useful but make support harder. Do not enable extra effects, complex HTML blocks, too many colors, or unusual click actions just because they are available. Start with a clear, understandable map and add behavior gradually.

A safe approach: after each noticeable change, save the map, clear cache if needed, and check one public URL. If the result gets worse, roll back the last change instead of rebuilding the entire map.

How to Maintain Map Data After Launch

An interactive map rarely stays unchanged. Companies open new branches, service areas shift, temporary locations close, and regional pages are added. That is why you should decide during setup how the map will be maintained. If you skip that step, a few months later the administrator may be looking at a set of regions, colors, and links with no explanation of why they were created.

The most reliable method is to keep a simple internal register next to the map. It can be a table in a document, a task in a project management system, or a separate internal article for editors. The register should record the map name, map type, list of regions or markers, target URLs, responsible editor, and the date of the last internal review. In the site's own documentation, you can add a short note such as: "Data source for the regional map is the sales department table; changes are made by the site editor after confirmation from the department lead."

This kind of register is especially useful for regional maps. A region's color often carries meaning: served, opening later, partner service only, temporarily unavailable. If that meaning is not documented, the next editor may choose a "similar shade" and break the legend. With markers, the same issue appears in addresses: an old office may remain on the map if there is no verification process.

Mini Update Process

1. The editor receives confirmation that the region, office, or zone has actually changed.
2. The internal register is updated before the map is edited so older data is not lost.
3. Only the required region, marker, or SVG zone is changed in Linky Map.
4. The public page is checked without administrator rights.
5. If cache is enabled, the page is cleared and checked again.

This process feels bureaucratic only for the first map. Once there are several maps, it protects the site from a common mistake: one map is updated, another still shows old data, and a third points to a deleted page. To a visitor, that looks like the site's information cannot be trusted.

How to Display the Map: Menu, Module, and Article Embed

One practical feature of Linky Map is that it offers multiple publishing methods. JoomUnited documentation describes display through a menu item, module, and content plugin. These are not interchangeable buttons. They are different ways to place the map into the structure of the site. The right choice depends on where the map should appear and who will edit it.

A Menu Item for a Dedicated Map Page

A menu item works well when the map is a standalone page: "Branch Map," "Delivery Regions," "Our Locations," or "Facility Layout." This option is easier to verify because the map has its own URL, clear navigation, and less dependency on the article where it might otherwise be embedded.

When creating the menu item, check not only the item type but also the access level. If the map page must be public, neither the menu item nor the linked map should be restricted for guests. If the map is intended for employees, limit it to the appropriate group and make sure a guest user cannot see internal data.

A Module for a Sidebar, Landing Page, or Repeated Display

A module is suitable when the map needs to live in a template position: a sidebar, below the content, on a landing page, next to a request form, or in a separate homepage block. In Joomla, this is a familiar mechanism, but it is also where mistakes often happen: the module is published but not assigned to the correct menu item, the position is not rendered in the template, or the position is too narrow for the map.

After configuring the module, check three things:

• The module is published and the correct map instance is selected.
• The module is assigned to the intended menu items and is not hidden on the current page.
• The template position actually exists and has enough space for the map.

Embedding in an Article Through the Content Plugin

Embedding in an article is useful when the map should be part of an explanatory article, for example, "How to Choose the Nearest Branch" or "Which Regions the Company Serves." In this case, the editor can place the map exactly where it belongs in the text instead of asking a developer to change the template.

This method has one important detail: the content plugin must be enabled, and the article must process the special embed code. If the map does not appear inside the article, first check the plugin status and the accuracy of the inserted syntax, and only then start changing map data.

Module Positions, ACL, and Editorial Responsibility

For a Joomla project, it is important not only to choose the display method, but also to assign responsibility. If a developer publishes the map and a content manager updates it, the manager should have access only to the parts they actually change. That may be the Linky Map component, a specific module, an article with the embed, or a menu item. Do not grant extra permissions "just in case": the map may contain links to regional pages, and an accidental change to the display method can quickly affect public navigation.

Check ACL in two directions. First, who can edit the map in the admin panel. Second, who can see the map on the site. An internal branch map for employees should not accidentally become public, and a public service-region map should not disappear for guests because of a restricted menu item or module. This matters especially on sites with multiple user groups.

Module positions also need oversight. In some templates, a position may exist only on a specific page layout. If the Linky Map module appears on the homepage but not in an article, check not only the menu assignment, but also whether the template renders that position in the current layout. For long maps, choose a wide position below the main content; for a compact branch map, a block next to contact information or a form may work better.

Editorial rule: if the same map instance is used in several places, check every display page before editing it. A change to color, link, or click behavior may make sense on one page and be unexpected on another.

Quick takeaway: a dedicated page is better when the map is the main navigation tool, a module is better for repeated display in the template, and an article embed is better for instructional or reference content that includes the map inline.

Practical Example: A Service Regions Map with Click-Through Links

Let us look at a specific scenario: a company website wants to show service regions and let the user click through to the page for their region. This is a strong example for Linky Map because the map helps the user do more than just "see the geography." It helps them choose where to go next on the site.

Goal

You need to create a "Service Regions" page with an interactive map. Active regions are highlighted, the user sees the region name on hover, and a click takes them to a local page with contacts, terms, or a list of services.

Preparation

Before configuration, prepare a list of regions and the URLs of the local pages. If the pages are not ready yet, create drafts with clear addresses. Do not tie the map to temporary links that you will later have to change in bulk.

For each region, prepare a working row with:

• The region name as seen by the user.
• The code or geographic identifier required by the chosen map.
• A status color: active, coming soon, not served.
• A link to the region page.
• A short phrase for the tooltip or HTML block.

Setup Steps

1. Create a new regional map in the Linky Map component and give it a clear internal name.
2. Select the geographic area that matches your task: a country, group of countries, continent, or another available level.
3. Add the first region and verify that its code is recognized.
4. Set the active-state color and hover behavior.
5. Add the link to the local page and a short description for the user.
6. Save the map and display it through a menu item on a test page.
7. Open the page as a regular visitor and verify the click action, tooltip, and navigation.

After a successful test, add the remaining regions in batches. Do not load the entire list at once if you have not verified the first set. If an error appears after adding the tenth region, it is much easier to find the problem in the last batch than in the full data set.

Expected Result

The user sees the map, understands which regions are active, gets a tooltip while interacting with it, and goes to the correct page. The site editor can update the region description or link in one place without touching the template.

A Detail That Often Gets in the Way

If clicking a region does not take the user to the correct page, the issue may not be the link itself but the selected action type. Make sure the region is configured with an actual redirect or the intended click behavior, not just a tooltip. If you are using an HTML sidebar or modal window, verify that the link inside the description is visible and clickable.

Verifying the Result: The Map Should Work as Part of the Site

Verifying a map is not just about asking whether it is visible on the page. An interactive map should be understandable, fast, accessible, and should not break the other elements of the page. You need to review it both through the eyes of a user and through the eyes of an administrator.

Checking the Site Front End

Open the map page without administrator rights. This helps catch access problems, hidden modules, and cache issues. Run through the normal scenario: page load, first impression, hover or tap, click, navigation, back button. If the map needs explanation, add a short line above it: "Select a region on the map to open the local office page."

On smaller screens, the map may take up a lot of space. You do not need to turn it into a separate mobile interface, but you do need to make sure the user can scroll the page, read the tooltip, and tap the link. If a modal window does not fit, it is often better to use shorter descriptions or place the map on a dedicated page.

Administrator Check

For the administrator, it is important to understand where the data source lives. If the map is displayed through a module and the editor is looking for it inside an article, support will become slow. Create an internal note: the map name, display method, menu item or module, who is responsible for region updates, and where the original list of addresses or the SVG is stored.

After changing data, verify:

• Whether the public map updated after clearing cache.
• Whether any region or marker links broke.
• Whether the block width changed in the template.
• Whether the map is covering important text or a nearby form.
• Whether the map interferes with indexing of the page's main content.

SEO, Speed, and Accessibility

A map can help with navigation, but it should not replace text information entirely. Search engines and users with accessibility limitations still need standard text: a list of regions, links to branch pages, contact details, or a brief description. That is why it is a good idea to keep a text version of the main directions near the map, or at least a list of key links.

From a performance standpoint, check how the page loads before and after the map is added. If the map appears on the homepage, its impact will be more noticeable. If it is only needed on a "Branches" page, do not display the module across the entire site. An interactive element should appear where it solves a problem, not on every page just for visibility.

Pre-Publication Checklist Matrix

Before showing the map to visitors, it helps to walk through a small verification matrix. It does not replace testing, but it helps you avoid missing systemic issues: data, behavior, access, responsiveness, and support. This is especially useful if one person creates the map and another publishes the site.

The matrix is also useful because it helps avoid vague arguments. If the map is not working, the team can focus on a specific area: data, display, behavior, access, or support. That is faster than saying "the map is broken" without identifying the exact symptom.

Safe Improvements Without Editing the Extension Code

With Linky Map, you should not start by editing the extension files. A product update can overwrite those changes, and unverified hooks or classes can easily break the map. It is better to use Joomla's safer layers: component settings, module positions, access permissions, language overrides, template styles, and careful CSS wrappers.

A CSS Wrapper for Width and Spacing

If the map is inserted into an article or module and sits too close to the text, you can wrap the output area in a template container or add CSS to your own block without touching the Linky Map files. This does not change the extension logic. It simply helps the page look cleaner.

This example works if you can add your own class to the article container, module block, or a wrapper in the template:

.linky-map-guide-wrap {
  max-width: 1100px;
  margin: 24px auto;
  overflow-x: auto;
}

.linky-map-guide-wrap img,
.linky-map-guide-wrap svg,
.linky-map-guide-wrap iframe {
  max-width: 100%;
}

The check is simple: after adding the CSS, the map should not overflow the content area, and on a narrow screen the user should still be able to view the entire interactive block. Rolling back is just as simple: remove the class or the rules from the template styles. Do not apply this CSS globally to every SVG and iframe on the site without a wrapper, or you may affect unrelated elements.

Language Overrides Instead of Editing Text in Files

If the interface or public output of the extension uses a Joomla system string, check language overrides first. This is the standard way to change a label without editing extension files. It is safer than searching for the string in PHP files and changing it manually.

The approach is straightforward: find the exact language key in the Joomla interface, create an override for the required language, save it, and check the public page. If the string does not change, the text may be part of the map data, the HTML description, or the template, in which case it should be edited in the relevant location rather than through an override.

Compatibility with Cache and Optimization

If the map uses external scripts and dynamic behavior, aggressive JavaScript optimization can affect the result. Do not disable the entire site cache right away. First test the map page without script combining or deferred loading, if your optimizer offers those settings. Then turn optimization back on one group at a time and check the map after each step.

This approach helps identify the exact cause. If the map disappears after one setting is enabled, you know what to exclude: that specific page or map script, rather than fighting "cache" blindly.

Another safe technique is to keep a separate test page for the map that uses the same display method but has no extra content around it. This is a control page: if the map works there but not on the production page, the problem is almost certainly in the template, module position, a neighboring script, or the settings of a specific menu item. If the map does not work there either, go back to the component, the data, and the library loading.

Do not add unverified JavaScript patches to the template to "restart" the map manually. Without an official API, that is risky and hard to maintain. It is better to find the specific conflict: script load order, optimization exclusions, availability of the external library, a data error, or the wrong display method.

When JoomUnited Linky Map Is the Right Choice

Linky Map is worth using when an interactive map helps the user make a decision or move to the right section of the site. That may involve choosing a region, branch, service zone, pavilion, office, partner, or a custom area on an SVG layout. In those scenarios, the extension provides a clear chain: data in the component, display through Joomla, and a working result on the public page.

Before launching it on a live site, verify the basics at minimum: the map was created in the right mode, the region or marker data is accurate, the display location was chosen deliberately, cache is not hiding changes, and there are text links or an explanation near the map. If all of that is in place, you can move on to testing on a real page and download the ZIP package for the next installation step.

If instead you need a full location directory with search, filters, and a large number of addresses, compare the task with alternative solutions. For regional maps, custom SVG layouts, and visual territory-based navigation, JoomUnited Linky Map remains the more direct solution, especially when it matters to preserve Joomla's familiar workflow through a component, module, menu, and articles.