Title: Template Map
Author: Jon Christopher
Published: <strong>18. Juli 2014</strong>
Last modified: 10. Februar 2022

---

Search plugins

![](https://ps.w.org/template-map/assets/banner-772x250.jpg?rev=951721)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/template-map_d59f6f.svg)

# Template Map

 By [Jon Christopher](https://profiles.wordpress.org/jchristopher/)

[Download](https://downloads.wordpress.org/plugin/template-map.1.0.1.zip)

 * [Details](https://ltz.wordpress.org/plugins/template-map/#description)
 * [Reviews](https://ltz.wordpress.org/plugins/template-map/#reviews)
 *  [Installation](https://ltz.wordpress.org/plugins/template-map/#installation)
 * [Development](https://ltz.wordpress.org/plugins/template-map/#developers)

 [Support](https://wordpress.org/support/plugin/template-map/)

## Description

Template Map is a utility plugin designed to make the creation and management of
navigation elements in your custom theme that much easier. It abstracts the need
to hard code post IDs and the like from your global and header navigation systems(
if you choose to not use Menus) for instance.

#### For Example

Many times you may use something like the following to build your main site navigation:

    ```
    <nav>
      <ul>
        <li>
          <a href="<?php echo get_permalink( 83 ); ?>">About</a>
        </li>
      </ul>
    </nav>
    ```

That works great during initial development, and continues to hold up when you migrate
to production en masse for the first time. But what about when you’re making subsequent
updates and the post IDs in your development environment are different than those
in production? You could take the time to sync the databases each and every time,
but that’s a bit overkill. Here’s where Template Map comes in to play:

    ```
    <nav>
      <ul>
        <li>
          <?php $about_page_id = TemplateMap()->get_id_from_template( 'template-about.php' ); ?>
          <a href="<?php echo get_permalink( $about_page_id ); ?>">About</a>
        </li>
      </ul>
    </nav>
    ```

Template Map allows you to _dynamically_ retreive your desired post ID based on 
the Page Template you told it to use. Page Template filenames rarely (if ever) change,
so it’s the core concept of Template Map’s implementation. Everything works backwards
from here.

Naturally this philosophy assumes your Page Template is used only once, it’s important
to keep that in mind. Modern client sites often use unique Page Templates for the‘
parent’ pages of each site section.

#### Current Site Section

Template Map also makes it easier to determine whether the current page is within
a site ‘section’ which is defined as a top level Page with a unique Page Template
that has any number of child Pages and/or Custom Post Types within it. This is very
useful when trying to set a ‘current’ state in your navigation, for example:

    ```
    <nav>
      <ul>
        <li class="<?php if( TemplateMap()->maybe_in_section( 'template-about.php' ) ) : ?> current<?php endif; ?>">
          <?php $about_page_id = TemplateMap()->get_id_from_template( 'template-about.php' ); ?>
          <a href="<?php echo get_permalink( $about_page_id ); ?>">About</a>
        </li>
      </ul>
    </nav>
    ```

Based on the same principle you can use this utility method to properly orient yourself
when outputting conditional classes contingent on the current page being within 
a ‘secton’ on your site.

## Installation

 1. Upload `templatemap` to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Replace calls to `get_permalink( 83 )` with `get_permalink( TemplateMap()->get_id_from_template('
    template-about.php' ) )` where `template-about.php` is the Page you wish to link

## FAQ

### How do I define Custom Post Types within a section?

There’s a filter for that. `template_map_post_types` accepts two parameters, the
second of which is the Page Template filename in question. You can conditionally
return an array of CPT names that will be utilized when checking to see whether 
the current page is within the section in question.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Template Map” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ Jon Christopher ](https://profiles.wordpress.org/jchristopher/)

[Translate “Template Map” into your language.](https://translate.wordpress.org/projects/wp-plugins/template-map)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/template-map/), check
out the [SVN repository](https://plugins.svn.wordpress.org/template-map/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/template-map/) by
[RSS](https://plugins.trac.wordpress.org/log/template-map/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.1

 * When using maybe_in_section you can pass a 2nd parameter to force a parent ID

#### 1.0

 * Initial release

## Meta

 *  Version **1.0.1**
 *  Last updated **4 Joren ago**
 *  Active installations **10+**
 *  WordPress version ** 3.9 or higher **
 *  Tested up to **5.9.0**
 *  Language
 * [English (US)](https://wordpress.org/plugins/template-map/)
 * Tags
 * [link](https://ltz.wordpress.org/plugins/tags/link/)[template](https://ltz.wordpress.org/plugins/tags/template/)
 *  [Advanced View](https://ltz.wordpress.org/plugins/template-map/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/template-map/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/template-map/reviews/)

## Contributors

 *   [ Jon Christopher ](https://profiles.wordpress.org/jchristopher/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/template-map/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://mondaybynoon.com/donate/)