get_footer

The timeline below displays how wordpress function get_footer has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.2

/**
 * Loads footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialized footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 * @since 5.5.0 A return value was added.
 * @since 5.5.0 The `$args` parameter was added.
 *
 * @param string $name The name of the specialized footer.
 * @param array  $args Optional. Additional arguments passed to the footer template.
 *                     Default empty array.
 * @return void|false Void on success, false if the template does not exist.
 */
function get_footer($name = null, $args = array())
{
    /**
     * Fires before the footer template file is loaded.
     *
     * @since 2.1.0
     * @since 2.8.0 The `$name` parameter was added.
     * @since 5.5.0 The `$args` parameter was added.
     *
     * @param string|null $name Name of the specific footer file to use. Null for the default footer.
     * @param array       $args Additional arguments passed to the footer template.
     */
    do_action('get_footer', $name, $args);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    if (!locate_template($templates, true, true, $args)) {
        return false;
    }
}

WordPress Version: 6.1

/**
 * Loads footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 * @since 5.5.0 A return value was added.
 * @since 5.5.0 The `$args` parameter was added.
 *
 * @param string $name The name of the specialised footer.
 * @param array  $args Optional. Additional arguments passed to the footer template.
 *                     Default empty array.
 * @return void|false Void on success, false if the template does not exist.
 */
function get_footer($name = null, $args = array())
{
    /**
     * Fires before the footer template file is loaded.
     *
     * @since 2.1.0
     * @since 2.8.0 The `$name` parameter was added.
     * @since 5.5.0 The `$args` parameter was added.
     *
     * @param string|null $name Name of the specific footer file to use. Null for the default footer.
     * @param array       $args Additional arguments passed to the footer template.
     */
    do_action('get_footer', $name, $args);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    if (!locate_template($templates, true, true, $args)) {
        return false;
    }
}

WordPress Version: 5.5

/**
 * Load footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 * @since 5.5.0 A return value was added.
 * @since 5.5.0 The `$args` parameter was added.
 *
 * @param string $name The name of the specialised footer.
 * @param array  $args Optional. Additional arguments passed to the footer template.
 *                     Default empty array.
 * @return void|false Void on success, false if the template does not exist.
 */
function get_footer($name = null, $args = array())
{
    /**
     * Fires before the footer template file is loaded.
     *
     * @since 2.1.0
     * @since 2.8.0 The `$name` parameter was added.
     * @since 5.5.0 The `$args` parameter was added.
     *
     * @param string|null $name Name of the specific footer file to use. Null for the default footer.
     * @param array       $args Additional arguments passed to the footer template.
     */
    do_action('get_footer', $name, $args);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    if (!locate_template($templates, true, true, $args)) {
        return false;
    }
}

WordPress Version: 4.9

/**
 * Load footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 *
 * @param string $name The name of the specialised footer.
 */
function get_footer($name = null)
{
    /**
     * Fires before the footer template file is loaded.
     *
     * @since 2.1.0
     * @since 2.8.0 $name parameter added.
     *
     * @param string|null $name Name of the specific footer file to use. null for the default footer.
     */
    do_action('get_footer', $name);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    locate_template($templates, true);
}

WordPress Version: 4.7

/**
 * Load footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 *
 * @param string $name The name of the specialised footer.
 */
function get_footer($name = null)
{
    /**
     * Fires before the footer template file is loaded.
     *
     * The hook allows a specific footer template file to be used in place of the
     * default footer template file. If your file is called footer-new.php,
     * you would specify the filename in the hook as get_footer( 'new' ).
     *
     * @since 2.1.0
     * @since 2.8.0 $name parameter added.
     *
     * @param string|null $name Name of the specific footer file to use. null for the default footer.
     */
    do_action('get_footer', $name);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    locate_template($templates, true);
}

WordPress Version: 4.5

/**
 * Load footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 *
 * @param string $name The name of the specialised footer.
 */
function get_footer($name = null)
{
    /**
     * Fires before the footer template file is loaded.
     *
     * The hook allows a specific footer template file to be used in place of the
     * default footer template file. If your file is called footer-new.php,
     * you would specify the filename in the hook as get_footer( 'new' ).
     *
     * @since 2.1.0
     * @since 2.8.0 $name parameter added.
     *
     * @param string $name Name of the specific footer file to use.
     */
    do_action('get_footer', $name);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    locate_template($templates, true);
}

WordPress Version: 4.1

/**
 * Load footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 *
 * @param string $name The name of the specialised footer.
 */
function get_footer($name = null)
{
    /**
     * Fires before the footer template file is loaded.
     *
     * The hook allows a specific footer template file to be used in place of the
     * default footer template file. If your file is called footer-new.php,
     * you would specify the filename in the hook as get_footer( 'new' ).
     *
     * @since 2.1.0
     * @since 2.8.0 $name parameter added.
     *
     * @param string $name Name of the specific footer file to use.
     */
    do_action('get_footer', $name);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    // Backward compat code will be removed in a future release
    if ('' == locate_template($templates, true)) {
        load_template(ABSPATH . WPINC . '/theme-compat/footer.php');
    }
}

WordPress Version: 3.9

/**
 * Load footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @since 1.5.0
 *
 * @uses locate_template()
 *
 * @param string $name The name of the specialised footer.
 */
function get_footer($name = null)
{
    /**
     * Fires before the footer template file is loaded.
     *
     * The hook allows a specific footer template file to be used in place of the
     * default footer template file. If your file is called footer-new.php,
     * you would specify the filename in the hook as get_footer( 'new' ).
     *
     * @since 2.1.0
     * @since 2.8.0 $name parameter added.
     *
     * @param string $name Name of the specific footer file to use.
     */
    do_action('get_footer', $name);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    // Backward compat code will be removed in a future release
    if ('' == locate_template($templates, true)) {
        load_template(ABSPATH . WPINC . '/theme-compat/footer.php');
    }
}

WordPress Version: 3.7

/**
 * Load footer template.
 *
 * Includes the footer template for a theme or if a name is specified then a
 * specialised footer will be included.
 *
 * For the parameter, if the file is called "footer-special.php" then specify
 * "special".
 *
 * @uses locate_template()
 * @since 1.5.0
 * @uses do_action() Calls 'get_footer' action.
 *
 * @param string $name The name of the specialised footer.
 */
function get_footer($name = null)
{
    do_action('get_footer', $name);
    $templates = array();
    $name = (string) $name;
    if ('' !== $name) {
        $templates[] = "footer-{$name}.php";
    }
    $templates[] = 'footer.php';
    // Backward compat code will be removed in a future release
    if ('' == locate_template($templates, true)) {
        load_template(ABSPATH . WPINC . '/theme-compat/footer.php');
    }
}