woocommerce/includes/wc-page-functions.php

228 lines
6.9 KiB
PHP
Raw Normal View History

2013-08-09 16:11:15 +00:00
<?php
/**
2015-11-03 13:53:50 +00:00
* WooCommerce Page Functions
2013-08-09 16:11:15 +00:00
*
* Functions related to pages and menus.
*
2017-11-20 22:19:09 +00:00
* @package WooCommerce\Functions
2016-01-14 19:48:30 +00:00
* @version 2.6.0
2013-08-09 16:11:15 +00:00
*/
defined( 'ABSPATH' ) || exit;
2015-11-06 09:22:19 +00:00
/**
2015-11-03 13:31:20 +00:00
* Replace a page title with the endpoint title.
2017-11-20 22:19:09 +00:00
*
* @param string $title Post title.
* @return string
*/
function wc_page_endpoint_title( $title ) {
global $wp_query;
if ( ! is_null( $wp_query ) && ! is_admin() && is_main_query() && in_the_loop() && is_page() && is_wc_endpoint_url() ) {
2017-11-20 22:19:09 +00:00
$endpoint = WC()->query->get_current_endpoint();
$action = isset( $_GET['action'] ) ? sanitize_text_field( wp_unslash( $_GET['action'] ) ) : '';
$endpoint_title = WC()->query->get_endpoint_title( $endpoint, $action );
2017-11-20 22:19:09 +00:00
$title = $endpoint_title ? $endpoint_title : $title;
remove_filter( 'the_title', 'wc_page_endpoint_title' );
}
return $title;
}
add_filter( 'the_title', 'wc_page_endpoint_title' );
2013-08-09 16:11:15 +00:00
/**
2015-11-03 13:31:20 +00:00
* Retrieve page ids - used for myaccount, edit_address, shop, cart, checkout, pay, view_order, terms. returns -1 if no page is found.
2013-08-09 16:11:15 +00:00
*
2017-11-20 22:19:09 +00:00
* @param string $page Page slug.
2013-08-09 16:11:15 +00:00
* @return int
*/
function wc_get_page_id( $page ) {
2017-11-20 22:19:09 +00:00
if ( 'pay' === $page || 'thanks' === $page ) {
2016-11-23 16:15:00 +00:00
wc_deprecated_argument( __FUNCTION__, '2.1', 'The "pay" and "thanks" pages are no-longer used - an endpoint is added to the checkout instead. To get a valid link use the WC_Order::get_checkout_payment_url() or WC_Order::get_checkout_order_received_url() methods instead.' );
2013-08-09 16:11:15 +00:00
$page = 'checkout';
}
2016-09-07 22:32:24 +00:00
if ( 'change_password' === $page || 'edit_address' === $page || 'lost_password' === $page ) {
2016-11-23 16:15:00 +00:00
wc_deprecated_argument( __FUNCTION__, '2.1', 'The "change_password", "edit_address" and "lost_password" pages are no-longer used - an endpoint is added to the my-account instead. To get a valid link use the wc_customer_edit_account_url() function instead.' );
2013-08-09 16:11:15 +00:00
$page = 'myaccount';
}
$page = apply_filters( 'woocommerce_get_' . $page . '_page_id', get_option( 'woocommerce_' . $page . '_page_id' ) );
2013-08-09 16:11:15 +00:00
return $page ? absint( $page ) : -1;
2013-08-09 16:11:15 +00:00
}
2015-02-15 19:13:22 +00:00
/**
2015-11-03 13:31:20 +00:00
* Retrieve page permalink.
2015-02-15 19:13:22 +00:00
*
* @param string $page page slug.
* @param string|bool $fallback Fallback URL if page is not set. Defaults to home URL. @since 3.4.0.
2015-02-15 19:13:22 +00:00
* @return string
*/
function wc_get_page_permalink( $page, $fallback = null ) {
$page_id = wc_get_page_id( $page );
$permalink = 0 < $page_id ? get_permalink( $page_id ) : '';
if ( ! $permalink ) {
$permalink = is_null( $fallback ) ? get_home_url() : $fallback;
}
return apply_filters( 'woocommerce_get_' . $page . '_page_permalink', $permalink );
2015-02-15 19:13:22 +00:00
}
2013-08-09 16:11:15 +00:00
/**
2015-11-03 13:31:20 +00:00
* Get endpoint URL.
2013-08-09 16:11:15 +00:00
*
* Gets the URL for an endpoint, which varies depending on permalink settings.
*
2017-11-20 22:19:09 +00:00
* @param string $endpoint Endpoint slug.
* @param string $value Query param value.
* @param string $permalink Permalink.
*
2013-08-09 16:11:15 +00:00
* @return string
*/
function wc_get_endpoint_url( $endpoint, $value = '', $permalink = '' ) {
if ( ! $permalink ) {
2013-08-09 16:11:15 +00:00
$permalink = get_permalink();
}
2013-08-09 16:11:15 +00:00
// Map endpoint to options.
$query_vars = WC()->query->get_query_vars();
2017-11-20 22:19:09 +00:00
$endpoint = ! empty( $query_vars[ $endpoint ] ) ? $query_vars[ $endpoint ] : $endpoint;
$value = ( get_option( 'woocommerce_myaccount_edit_address_endpoint', 'edit-address' ) === $endpoint ) ? wc_edit_address_i18n( $value ) : $value;
2013-09-03 15:14:56 +00:00
if ( get_option( 'permalink_structure' ) ) {
if ( strstr( $permalink, '?' ) ) {
2017-11-20 22:19:09 +00:00
$query_string = '?' . wp_parse_url( $permalink, PHP_URL_QUERY );
$permalink = current( explode( '?', $permalink ) );
} else {
$query_string = '';
}
$url = trailingslashit( $permalink );
2018-02-19 13:14:07 +00:00
if ( $value ) {
$url .= trailingslashit( $endpoint ) . user_trailingslashit( $value );
} else {
$url .= user_trailingslashit( $endpoint );
2018-02-19 13:14:07 +00:00
}
$url .= $query_string;
} else {
2013-08-09 16:11:15 +00:00
$url = add_query_arg( $endpoint, $value, $permalink );
}
2013-08-09 16:11:15 +00:00
return apply_filters( 'woocommerce_get_endpoint_url', $url, $endpoint, $value, $permalink );
2013-08-09 16:11:15 +00:00
}
/**
2015-11-03 13:31:20 +00:00
* Hide menu items conditionally.
2013-08-09 16:11:15 +00:00
*
* @param array $items Navigation items.
2013-08-09 16:11:15 +00:00
* @return array
*/
2014-11-20 00:43:09 +00:00
function wc_nav_menu_items( $items ) {
2013-08-09 16:11:15 +00:00
if ( ! is_user_logged_in() ) {
2014-11-20 00:43:09 +00:00
$customer_logout = get_option( 'woocommerce_logout_endpoint', 'customer-logout' );
2013-08-09 16:11:15 +00:00
if ( ! empty( $customer_logout ) && ! empty( $items ) && is_array( $items ) ) {
foreach ( $items as $key => $item ) {
if ( empty( $item->url ) ) {
continue;
}
2017-11-20 22:19:09 +00:00
$path = wp_parse_url( $item->url, PHP_URL_PATH );
$query = wp_parse_url( $item->url, PHP_URL_QUERY );
2016-05-31 06:46:05 +00:00
if ( strstr( $path, $customer_logout ) || strstr( $query, $customer_logout ) ) {
unset( $items[ $key ] );
}
2014-11-20 00:43:09 +00:00
}
2013-08-09 16:11:15 +00:00
}
}
2014-11-20 00:43:09 +00:00
2016-07-11 14:56:35 +00:00
return $items;
2013-08-09 16:11:15 +00:00
}
2014-11-20 00:43:09 +00:00
add_filter( 'wp_nav_menu_objects', 'wc_nav_menu_items', 10 );
2013-08-09 16:11:15 +00:00
/**
* Fix active class in nav for shop page.
*
2017-11-20 22:19:09 +00:00
* @param array $menu_items Menu items.
2013-08-09 16:11:15 +00:00
* @return array
*/
2014-11-20 00:43:09 +00:00
function wc_nav_menu_item_classes( $menu_items ) {
if ( ! is_woocommerce() ) {
return $menu_items;
}
2013-08-09 16:11:15 +00:00
$shop_page = wc_get_page_id( 'shop' );
2013-08-09 16:11:15 +00:00
$page_for_posts = (int) get_option( 'page_for_posts' );
if ( ! empty( $menu_items ) && is_array( $menu_items ) ) {
foreach ( $menu_items as $key => $menu_item ) {
$classes = (array) $menu_item->classes;
2017-11-20 22:19:09 +00:00
$menu_id = (int) $menu_item->object_id;
2013-08-09 16:11:15 +00:00
2017-11-20 22:19:09 +00:00
// Unset active class for blog page.
if ( $page_for_posts === $menu_id ) {
$menu_items[ $key ]->current = false;
2017-11-20 22:19:09 +00:00
if ( in_array( 'current_page_parent', $classes, true ) ) {
unset( $classes[ array_search( 'current_page_parent', $classes, true ) ] );
}
2013-08-09 16:11:15 +00:00
2017-11-20 22:19:09 +00:00
if ( in_array( 'current-menu-item', $classes, true ) ) {
unset( $classes[ array_search( 'current-menu-item', $classes, true ) ] );
}
2017-11-20 22:19:09 +00:00
} elseif ( is_shop() && $shop_page === $menu_id && 'page' === $menu_item->object ) {
// Set active state if this is the shop page link.
$menu_items[ $key ]->current = true;
$classes[] = 'current-menu-item';
$classes[] = 'current_page_item';
2013-08-09 16:11:15 +00:00
2017-11-20 22:19:09 +00:00
} elseif ( is_singular( 'product' ) && $shop_page === $menu_id ) {
// Set parent state if this is a product page.
$classes[] = 'current_page_parent';
}
2013-08-09 16:11:15 +00:00
$menu_items[ $key ]->classes = array_unique( $classes );
}
2013-08-09 16:11:15 +00:00
}
return $menu_items;
}
2014-11-20 00:43:09 +00:00
add_filter( 'wp_nav_menu_objects', 'wc_nav_menu_item_classes', 2 );
2013-08-09 16:11:15 +00:00
/**
* Fix active class in wp_list_pages for shop page.
*
2017-11-20 22:19:09 +00:00
* See details in https://github.com/woocommerce/woocommerce/issues/177.
2013-08-09 16:11:15 +00:00
*
2017-11-20 22:19:09 +00:00
* @param string $pages Pages list.
2013-08-09 16:11:15 +00:00
* @return string
*/
function wc_list_pages( $pages ) {
2018-05-15 02:08:18 +00:00
if ( ! is_woocommerce() ) {
return $pages;
}
// Remove current_page_parent class from any item.
$pages = str_replace( 'current_page_parent', '', $pages );
// Find shop_page_id through woocommerce options.
$shop_page = 'page-item-' . wc_get_page_id( 'shop' );
if ( is_shop() ) {
// Add current_page_item class to shop page.
return str_replace( $shop_page, $shop_page . ' current_page_item', $pages );
2016-07-11 14:56:35 +00:00
}
2018-05-15 02:08:18 +00:00
// Add current_page_parent class to shop page.
return str_replace( $shop_page, $shop_page . ' current_page_parent', $pages );
2013-08-09 16:11:15 +00:00
}
add_filter( 'wp_list_pages', 'wc_list_pages' );