/footer-text

Allow users to change the theme footer text easily from the dashboard

Primary LanguagePHPMIT LicenseMIT

Footer Text

  • Requires at least: WordPress 3.3 or later
  • Tested up to: WordPress 5.0
  • Stable version: 2.0.2
  • License: MIT

Allow changing of the theme footer text easily from the dashboard

Description

Provides an interface in the dashboard, similar to the post edit screen, that allows you to easily change the text displayed in the footer on the front-end. After installing the plugin, add the footer_text() template tag to your footer.php theme template where you want the text to display. For more options, see the FAQ.

You can use these shortcodes in the footer text editor:

  • [last_modified] the date that the current page was last modified on
  • [page_link] the full permalink of the current page, formatted. The content wrapped in this shortcode will be used as the link text
  • [year] the current year eg: 2013

Visit the plugin homepage, or review it on WordPress.org.

Installation

  1. Upload the footer-text directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Visit Appearance > Footer Text to write your awesome footer text
  4. Place the footer_text() template tag somewhere in your theme where you want the text displayed
  5. Visit site. Observe.

Then use the footer_text() template tag in your theme templates.

Frequently Asked Questions

How can I display the footer text in my theme?

You can use the footer_text() function to display the footer text, or the get_footer_text() function to return it for use in PHP. These template tags should generally be used in the footer.php file of your theme.

The footer_text() function outputs the formatted footer text and accepts three parameters: $before, $after and $default. $before will be outputted before the text, $after will be outputted after the text, and $default will be used instead of the text is none is set. If no text is set $default is empty, nothing will be displayed.

The get_footer_text() function returns the formatted footer text and accepts one parameter: $default, which will be returned if no text is set.

If the plugin isn't active, the template tag will result in an error. To solve this, you can use an action hook instead:

do_action( 'footer_text', $default, $before, $after );

This works the same as calling the footer_text() function, and any of the three arguments can be omitted.

Changelog

2.0.2

  • Use a <h1> heading on administration pages

2.0.1

  • Update screenshots for WordPress 3.9
  • Add braces to one-line conditionals

2.0.0

  • Delete footer text from database on uninstall
  • Added an action as an alternate way to display footer text
  • Restructured code
  • Fixed [page_link] shortcode
  • Added custom 'edit_footer_text' capability
  • Added support for translations

1.0.0

  • Initial release

Screenshots

Editing the footer text in the dashboard

Editing the footer text in the dashboard

Previewing the footer text on the Twenty Thirteen theme

Previewing the footer text on the Twenty Thirteen theme