Edit File by line

<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Helper to render small documentation/tooltips in the UI.

[2] Fix | Delete

[3] Fix | Delete

* @package LiteSpeed

[4] Fix | Delete

* @since 2.2.7

[5] Fix | Delete

[6] Fix | Delete

[7] Fix | Delete

namespace LiteSpeed;

[8] Fix | Delete

[9] Fix | Delete

defined( 'WPINC' ) || exit();

[10] Fix | Delete

[11] Fix | Delete

/**

[12] Fix | Delete

* Small utility view helpers for docs/warnings/links.

[13] Fix | Delete

[14] Fix | Delete

class Doc {

[15] Fix | Delete

[16] Fix | Delete

/**

[17] Fix | Delete

* Show a notice when an option is effectively forced ON by Guest Mode.

[18] Fix | Delete

[19] Fix | Delete

* @since 5.5

[20] Fix | Delete

[21] Fix | Delete

* @param string $id Option id.

[22] Fix | Delete

* @return void

[23] Fix | Delete

[24] Fix | Delete

public static function maybe_on_by_gm( $id ) {

[25] Fix | Delete

if ( apply_filters( 'litespeed_conf', $id ) ) {

[26] Fix | Delete

return;

[27] Fix | Delete

}

[28] Fix | Delete

if ( ! apply_filters( 'litespeed_conf', Base::O_GUEST ) ) {

[29] Fix | Delete

return;

[30] Fix | Delete

}

[31] Fix | Delete

if ( ! apply_filters( 'litespeed_conf', Base::O_GUEST_OPTM ) ) {

[32] Fix | Delete

return;

[33] Fix | Delete

}

[34] Fix | Delete

echo '<font class="litespeed-warning">';

[35] Fix | Delete

echo wp_kses_post(

[36] Fix | Delete

'⚠️ ' .

[37] Fix | Delete

sprintf(

[38] Fix | Delete

__( 'This setting is %1$s for certain qualifying requests due to %2$s!', 'litespeed-cache' ),

[39] Fix | Delete

'<code>' . esc_html__( 'ON', 'litespeed-cache' ) . '</code>',

[40] Fix | Delete

esc_html( Lang::title( Base::O_GUEST_OPTM ) )

[41] Fix | Delete

)

[42] Fix | Delete

);

[43] Fix | Delete

self::learn_more( 'https://docs.litespeedtech.com/lscache/lscwp/general/#guest-optimization' );

[44] Fix | Delete

echo '</font>';

[45] Fix | Delete

}

[46] Fix | Delete

[47] Fix | Delete

/**

[48] Fix | Delete

* Warn that changes affect the crawler list.

[49] Fix | Delete

[50] Fix | Delete

* @since 4.3

[51] Fix | Delete

* @return void

[52] Fix | Delete

[53] Fix | Delete

public static function crawler_affected() {

[54] Fix | Delete

echo '<span class="litespeed-primary">';

[55] Fix | Delete

echo '⚠️ ' . esc_html__( 'This setting will regenerate crawler list and clear the disabled list!', 'litespeed-cache' );

[56] Fix | Delete

echo '</span>';

[57] Fix | Delete

}

[58] Fix | Delete

[59] Fix | Delete

/**

[60] Fix | Delete

* Privacy policy text for front-end disclosure.

[61] Fix | Delete

[62] Fix | Delete

* @since 2.2.7

[63] Fix | Delete

[64] Fix | Delete

* @return string Safe HTML string.

[65] Fix | Delete

[66] Fix | Delete

public static function privacy_policy() {

[67] Fix | Delete

$text = esc_html__(

[68] Fix | Delete

'This site utilizes caching in order to facilitate a faster response time and better user experience. Caching potentially stores a duplicate copy of every web page that is on display on this site. All cache files are temporary, and are never accessed by any third party, except as necessary to obtain technical support from the cache plugin vendor. Cache files expire on a schedule set by the site administrator, but may easily be purged by the admin before their natural expiration, if necessary. We may use QUIC.cloud services to process & cache your data temporarily.',

[69] Fix | Delete

'litespeed-cache'

[70] Fix | Delete

);

[71] Fix | Delete

[72] Fix | Delete

$link = sprintf(

[73] Fix | Delete

/* translators: %s: QUIC.cloud privacy policy URL */

[74] Fix | Delete

esc_html__( 'Please see %s for more details.', 'litespeed-cache' ),

[75] Fix | Delete

sprintf(

[76] Fix | Delete

'<a href="%1$s" target="_blank" rel="noopener noreferrer">%1$s</a>',

[77] Fix | Delete

esc_url( 'https://quic.cloud/privacy-policy/' )

[78] Fix | Delete

)

[79] Fix | Delete

);

[80] Fix | Delete

[81] Fix | Delete

// Return as HTML (link already escaped).

[82] Fix | Delete

return $text . ' ' . $link;

[83] Fix | Delete

}

[84] Fix | Delete

[85] Fix | Delete

/**

[86] Fix | Delete

* Render (or return) a "Learn more" link.

[87] Fix | Delete

[88] Fix | Delete

* @since 2.4.2

[89] Fix | Delete

[90] Fix | Delete

* @param string $url Destination URL.

[91] Fix | Delete

* @param string $title Optional link text. Defaults to "Learn More".

[92] Fix | Delete

* @param bool $self_tab Open in self tab or new tab (adds target/_blank + rel).

[93] Fix | Delete

* @param string $css_class CSS class for the anchor.

[94] Fix | Delete

* @param bool $return_output Return instead of echo.

[95] Fix | Delete

* @return string|void

[96] Fix | Delete

[97] Fix | Delete

public static function learn_more( $url, $title = '', $self_tab = false, $css_class = '', $return_output = false ) {

[98] Fix | Delete

$css_class = $css_class ? $css_class : 'litespeed-learn-more';

[99] Fix | Delete

$title = $title ? $title : esc_html__( 'Learn More', 'litespeed-cache' );

[100] Fix | Delete

[101] Fix | Delete

$target_rel = $self_tab ? '' : ' target="_blank" rel="noopener noreferrer"';

[102] Fix | Delete

$anchor = sprintf(

[103] Fix | Delete

' <a href="%s"%s class="%s">%s</a>',

[104] Fix | Delete

esc_url( $url ),

[105] Fix | Delete

$target_rel, // Already hardcoded/safe.

[106] Fix | Delete

esc_attr( $css_class ),

[107] Fix | Delete

wp_kses_post( $title )

[108] Fix | Delete

);

[109] Fix | Delete

[110] Fix | Delete

if ( $return_output ) {

[111] Fix | Delete

return $anchor;

[112] Fix | Delete

}

[113] Fix | Delete

[114] Fix | Delete

echo wp_kses_post( $anchor );

[115] Fix | Delete

}

[116] Fix | Delete

[117] Fix | Delete

/**

[118] Fix | Delete

* Output "One per line." helper text.

[119] Fix | Delete

[120] Fix | Delete

* @since 3.0

[121] Fix | Delete

[122] Fix | Delete

* @param bool $return_output Return the string instead of echoing.

[123] Fix | Delete

* @return string|void

[124] Fix | Delete

[125] Fix | Delete

public static function one_per_line( $return_output = false ) {

[126] Fix | Delete

$str = esc_html__( 'One per line.', 'litespeed-cache' );

[127] Fix | Delete

if ( $return_output ) {

[128] Fix | Delete

return $str;

[129] Fix | Delete

}

[130] Fix | Delete

echo esc_html( $str );

[131] Fix | Delete

}

[132] Fix | Delete

[133] Fix | Delete

/**

[134] Fix | Delete

* Output helper text about full/partial URL support.

[135] Fix | Delete

[136] Fix | Delete

* @since 3.4

[137] Fix | Delete

[138] Fix | Delete

* @param bool $string_only If true, say "strings" only; otherwise specify URLs/strings.

[139] Fix | Delete

* @return void

[140] Fix | Delete

[141] Fix | Delete

public static function full_or_partial_url( $string_only = false ) {

[142] Fix | Delete

if ( $string_only ) {

[143] Fix | Delete

echo esc_html__( 'Both full and partial strings can be used.', 'litespeed-cache' );

[144] Fix | Delete

} else {

[145] Fix | Delete

echo esc_html__( 'Both full URLs and partial strings can be used.', 'litespeed-cache' );

[146] Fix | Delete

}

[147] Fix | Delete

}

[148] Fix | Delete

[149] Fix | Delete

/**

[150] Fix | Delete

* Notice that a setting will edit .htaccess.

[151] Fix | Delete

[152] Fix | Delete

* @since 3.0

[153] Fix | Delete

* @return void

[154] Fix | Delete

[155] Fix | Delete

public static function notice_htaccess() {

[156] Fix | Delete

echo '<span class="litespeed-primary">';

[157] Fix | Delete

echo '⚠️ ' . esc_html__( 'This setting will edit the .htaccess file.', 'litespeed-cache' ) . ' ';

[158] Fix | Delete

self::learn_more( 'https://docs.litespeedtech.com/lscache/lscwp/toolbox/#edit-htaccess-tab' );

[159] Fix | Delete

echo '</span>';

[160] Fix | Delete

}

[161] Fix | Delete

[162] Fix | Delete

/**

[163] Fix | Delete

* Gentle reminder that QUIC.cloud queues are asynchronous.

[164] Fix | Delete

[165] Fix | Delete

* @since 5.3.1

[166] Fix | Delete

[167] Fix | Delete

* @param bool $return_output Return the HTML instead of echoing.

[168] Fix | Delete

* @return string|void

[169] Fix | Delete

[170] Fix | Delete

public static function queue_issues( $return_output = false ) {

[171] Fix | Delete

$link = self::learn_more( 'https://docs.litespeedtech.com/lscache/lscwp/troubleshoot/#quiccloud-queue-issues', '', false, '', true );

[172] Fix | Delete

[173] Fix | Delete

$html = sprintf(

[174] Fix | Delete

'<div class="litespeed-desc">%s %s</div>',

[175] Fix | Delete

esc_html__( 'The queue is processed asynchronously. It may take time.', 'litespeed-cache' ),

[176] Fix | Delete

$link // already escaped.

[177] Fix | Delete

);

[178] Fix | Delete

[179] Fix | Delete

if ( $return_output ) {

[180] Fix | Delete

return $html;

[181] Fix | Delete

}

[182] Fix | Delete

[183] Fix | Delete

echo wp_kses_post( $html );

[184] Fix | Delete

}

[185] Fix | Delete

}

[186] Fix | Delete

[187] Fix | Delete