File: /var/www/ideasforum.kaunokolegija.lt/wp-content/plugins/simplistic-page-navi/explain.php
<table class="form-table">
<tr valign="top">
<td>Load style sheet</td>
<td><input type="number" name="splcpn_options[style]" value="<?php echo ( int )$this->ret_option['style']; ?>" min="0" max="6"></td>
<td>* <?php _e( '0:Don\'t load the style sheet (or specify it directly in the template using a function), 1:standard square design, 2:circle design, 3:circle white back, 4:circle orange back, 5:simple square, 6:white gradation', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Reverse List</td>
<td><select name="splcpn_options[reverse]">
<?php
$selected = array( '', '' );
if ( '1' === $this->ret_option['reverse'] ) {
$selected[1] = ' selected';
} else {
$selected[0] = ' selected';
}
?>
<option value="1"<?php echo $selected[1]; ?>><?php _e( 'reverse list', $this->domain ); ?></option>
<option value="0"<?php echo $selected[0]; ?>><?php _e( 'standard left start', $this->domain ); ?></option>
</select></td>
<td>* <?php _e( 'The list can be specified in reverse order from right to left.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Visibility of direct Jump box</td>
<td><input type="number" name="splcpn_options[above]" value="<?php echo intval( $this->ret_option['above'] ); ?>" min="2" max="1000"></td>
<td>* <?php _e( 'Specify the minimum number of all pages to display the input box for direct jump, and hide it if you enter a number that exceeds the number of all pages. Default is 7 pages.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Pixel value of madia query's max-width</td>
<td><input type="number" name="splcpn_options[nr_style]" value="<?php echo ( int )$this->ret_option['nr_style']; ?>" min="0" max="1500"></td>
<td>* <?php _e( 'This number sets the pixel value of max-width in media query for narrow screens such as mobile devices. The style of the hidden elements are output by wp_head. 0 means no style is output. The default value is 770.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>list of minimum unit</td>
<td><select name="splcpn_options[minimum_unit]">
<?php
$selected = array( '', '' );
if ( '0' === $this->ret_option['minimum_unit'] ) {
$selected[0] = ' selected';
} else {
$selected[1] = ' selected';
}
?>
<option value="1"<?php echo $selected[1]; ?>><?php _e( 'standard', $this->domain ); ?></option>
<option value="0"<?php echo $selected[0]; ?>><?php _e( 'minimun', $this->domain ); ?></option>
</select></td>
<td>* <?php _e( 'Displays a page list with the minimum number of elements required.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Number of pages that adjacent to current page to display list</td>
<td><input type="number" name="splcpn_options[adjacent_num]" value="<?php echo ( int )$this->ret_option['adjacent_num']; ?>" min="1" max="5"></td>
<td>* <?php _e( 'Enter the number of pages to display that are adjacent to the current page. Centered on the current page, if there are page numbers that can be displayed, they will be displayed on both sides of next/prev. The number to be entered is the number for one side only. <br>For example, if the current page number is 5, and you set this number to 2, the adjacent number displays will be 3, 4, 5, 6, and 7, two on each side of the current page.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Maximum number of larger page to display list</td>
<td><input type="number" name="splcpn_options[larger_page]" value="<?php echo ( int )$this->ret_option['larger_page']; ?>" min="0" max="5"></td>
<td>* <?php _e( 'Larger page means a multiple of 10. Specifies the number of larger page numbers to be displayed when there are many pages. This is also valid before and after the current page number, and all you need to specify is the number on one side of it. <br>For example, if 2 is specified for this number, the current page number is 25, and the total number of pages is 50, the page numbers displayed will be 10,20,...25,...,30,40. If 0 is specified, the larger pages will not be displayed at all.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Maximum number of hundreds place pages to display list</td>
<td><input type="number" name="splcpn_options[distant_num]" value="<?php echo ( int )$this->ret_option['distant_num']; ?>" min="0" max="5"></td>
<td>* <?php _e( 'Specifies the number of page numbers in multiples of 100 to be displayed when there are a large number of pages and when the distance from the beginning or end is large.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Label of 'to first page'</td>
<td><input type="text" name="splcpn_options[top_label]" value="<?php echo esc_attr( $this->ret_option['top_label'] ); ?>" maxlength="6"></td>
<td>* <?php _e( 'Input text of the link to the top page in less than six characters.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Label of 'to last page'</td>
<td><input type="text" name="splcpn_options[last_label]" value="<?php echo esc_attr( $this->ret_option['last_label'] ); ?>" maxlength="6"></td>
<td>* <?php _e( 'Input text of the link to the last page in less than six characters.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Connection string</td>
<td><input type="text" name="splcpn_options[connection_str]" value="<?php echo esc_attr( $this->ret_option['connection_str'] ); ?>" maxlength="3"></td>
<td>* <?php _e( 'Enter a string to be displayed between the page numbers when they are far apart in less than three characters.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Id string of parent div tag</td>
<td><input type="text" name="splcpn_options[div_id]" value="<?php echo esc_attr( $this->ret_option['div_id'] ); ?>" maxlength="20"></td>
<td>* <?php _e( 'Specifies the string that will be the id attribute of the parent element, <div> tag. Default is "pagenavilist".', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Font size</td>
<td><input type="number" name="splcpn_options[font_size]" value="<?php echo ( int )$this->ret_option['font_size']; ?>" min="-10" max="10"></td>
<td>* <?php _e( 'Set font size. Select 0 to disable. -10 : 0.5em ~ 10 : 1.5em, at intervals of 0.05em.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Text-align of id="toppagelink" <nav> tag</td>
<td><select name="splcpn_options[top_text_align]">
<?php
$selected = array( '', '', '', '' );
if ( '1' === $this->ret_option['top_text_align'] ) {
$selected[1] = ' selected';
} elseif ( '2' === $this->ret_option['top_text_align'] ) {
$selected[2] = ' selected';
} elseif ( '3' === $this->ret_option['top_text_align'] ) {
$selected[3] = ' selected';
} else {
$selected[0] = ' selected';
}
?>
<option value="0"<?php echo $selected[0]; ?>><?php _e( 'disable', $this->domain ); ?></option>
<option value="1"<?php echo $selected[1]; ?>><?php _e( 'left', $this->domain ); ?></option>
<option value="2"<?php echo $selected[2]; ?>><?php _e( 'right', $this->domain ); ?></option>
<option value="3"<?php echo $selected[3]; ?>><?php _e( 'center', $this->domain ); ?></option>
</select></td>
<td>* <?php _e( 'The text-align setting of the <nav> tag ( id="toppagelink" ) of the outermost parent element. ', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Margin of id="toppagelink" <nav> tag</td>
<td><input type="text" name="splcpn_options[top_margin]" value="<?php echo esc_attr( $this->ret_option['top_margin'] ); ?>" maxlength="24"></td>
<td>* <?php _e( 'The margin setting of the <nav> tag ( id="toppagelink" ) of the outermost parent element. If you don\'t enter anything, it is invalid. top:right:bottom:left, separated by ":". Available units, px, %, auto, if the unit is omitted and it is just a number, it will be px. Can be abbreviated in the same way as normal css formatting. Example: only one number 10, two 20:auto, three 10px:0:20%, all -20px:0:30:50%.', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Text-align of id="bottompagelink" <nav> tag</td>
<td><select name="splcpn_options[bottom_text_align]">
<?php
$selected = array( '', '', '', '' );
if ( '1' === $this->ret_option['bottom_text_align'] ) {
$selected[1] = ' selected';
} elseif ( '2' === $this->ret_option['bottom_text_align'] ) {
$selected[2] = ' selected';
} elseif ( '3' === $this->ret_option['bottom_text_align'] ) {
$selected[3] = ' selected';
} else {
$selected[0] = ' selected';
}
?>
<option value="0"<?php echo $selected[0]; ?>><?php _e( 'disable', $this->domain ); ?></option>
<option value="1"<?php echo $selected[1]; ?>><?php _e( 'left', $this->domain ); ?></option>
<option value="2"<?php echo $selected[2]; ?>><?php _e( 'right', $this->domain ); ?></option>
<option value="3"<?php echo $selected[3]; ?>><?php _e( 'center', $this->domain ); ?></option>
</select></td>
<td>* <?php _e( 'The text-align setting of the <nav> tag ( id="bottompagelink" ) of the outermost parent element. ', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Margin of id="bottompagelink" <nav> tag</td>
<td><input type="text" name="splcpn_options[bottom_margin]" value="<?php echo esc_attr( $this->ret_option['bottom_margin'] ); ?>" maxlength="24"></td>
<td>* <?php _e( 'The margin setting of the <nav> tag ( id="bottompagelink" ) of the outermost parent element. Same as "toppagelink".', $this->domain ); ?></td>
</tr>
<tr valign="top">
<td>Erase wp_link_pages output of theme default.</td>
<td><select name="splcpn_options[hidden_wplinkpages]">
<?php
$selected = array( '', '' );
if ( '0' === $this->ret_option['hidden_wplinkpages'] ) {
$selected[0] = ' selected';
} else {
$selected[1] = ' selected';
}
?>
<option value="1"<?php echo $selected[1]; ?>><?php _e( 'erase', $this->domain ); ?></option>
<option value="0"<?php echo $selected[0]; ?>><?php _e( 'show', $this->domain ); ?></option>
</select></td>
<td>* <?php _e( 'You can erase the navigation-pagenumbers output by wp_link_pages, which is the default function in WordPress.', $this->domain ); ?></td>
</tr>
</tr>
<tr valign="top">
<td> Page-lists outputted by javascript</td>
<td><input type="text" name="splcpn_options[js_output]" value="<?php echo esc_attr( $this->ret_option['js_output'] ); ?>" width="100"></td>
<td>* <?php _e( 'If you specify the ID of the HTML element you want the page-list to show in this option, the plugin will insert the page-list at the beginning and end of that element using Javascript. default is ""( empty string )->disabled<br>For example, the ID of the html element of main content of the standard WordPress theme ("21", "19", "17", "16") is "content", and "20" is "site-content".<br>If you have no experience with HTML at all, try entering the word "search" in this option box. If the plugin can successfully find the main content, it might work.<br>', $this->domain ); ?>
<?php _e( 'Then, if you enter the element ID followed by the css style, you can style the page-list inserted at the top and bottom as inline style.<br>Each should be separated by "^". -> ID^top-style(option)^bottom-style(option)<br>eg. content^width:50%;font-size:1.2em;background-color:lightblue;^font-size:0.9em;<br>', $this->domain ); ?>
<?php _e( 'If either style is specified, the page-list element itself will not be inserted if the other is left blank. If you need both, either specify nothing for both, or specify some style for both. For example, position:relative;.<br>eg. search^font-size:1.2em; -> only top, search^^font-size:1.2em; -> only bottom', $this->domain ); ?>
</td>
</tr>
<tr valign="top">
<td>Register block</td>
<td><select name="splcpn_options[en_gutenblock]">
<?php
$selected = array( '', '' );
if ( '0' === $this->ret_option['en_gutenblock'] ) {
$selected[0] = ' selected';
} else {
$selected[1] = ' selected';
}
?>
<option value="1"<?php echo $selected[1]; ?>><?php _e( 'enable', $this->domain ); ?></option>
<option value="0"<?php echo $selected[0]; ?>><?php _e( 'disable', $this->domain ); ?></option>
</select></td>
<td>* <?php _e( 'Register plugin\'s custom block for Gutenberg Block-Editor.', $this->domain ); ?></td>
</tr>
</table>
<p>* <?php _e( 'However, when it comes to style settings, it is recommended to disable all the above style-related options and put them all together in the theme\'s style sheet, just like any other style settings.', $this->domain ); ?></p>
<?php submit_button(); ?>
</form>
<p><?php _e( 'It is quite common to display two page link lists, one at the top of the page and one at the bottom. In that case, when the function is called a second time, it reuses the list created the first time in memory to avoid having to do the same process twice.', $this->domain ); ?></p>
<!-- ページの上部と下部に2つのページリンクリストを表示させることはよくあることだと思います。その場合、二度目に関数が呼び出されたときは、二度同じ処理をさせないために、一度目で作成したリストをメモリーしたものを再利用します。-->
<p><?php _e( 'If you want to uninstall the plugin, you can do so from the plugin page, and the option values will be removed from the database.', $this->domain ); ?></p>
<hr>
<p><?php _e( 'Usage', $this->domain ); ?></p>
<p><?php _e( 'A reliable way to display the page-list where you want it to display is to put the "splcpn_echopager" template tag in the template where you want it to display, as follows.', $this->domain ); ?></p>
<p><?php _e( 'However, if you don\'t want to touch HTML or php, you may want to try the "Page-lists outputted by javascript" option above.', $this->domain ); ?></p>
<pre>
<?php
if ( function_exists( 'splcpn_echopager' ) ) {
splcpn_echopager( 1 );
}
?>
</pre>
<p><?php _e( 'If you specify one parameter and a value of 1, as in this case, the HTML will be output as follows.', $this->domain ); ?></p>
<!-- この時、パラメータで1をセットすると以下のようにマークアップされます。 -->
<pre><nav id="toppagelink"><div class="wp-pagenavi">...</pre>
<p><?php _e( 'If you set 0 or if you omit it ( optional in the case because 0 is default value) is as follows. If you want to display it twice in the same page, you can setting of position in detail for each.', $this->domain ); ?></p>
<!-- 0、または省略した場合( 0の場合は省略可 )は以下のようになって、同じページ内で2度表示する場合に、それぞれの詳細な位置設定ができます。 -->
<pre><nav id="bottompagelink"><div class="wp-pagenavi">...</pre>
<p><?php _e( 'When the following parameters are specified as the second argument in an array, the first argument cannot be omitted even if the first argument value is 0 of default value. Also, be sure to put the values of the arguments in single or double quotes.', $this->domain ); ?></p>
<!-- その他のパラメータ（オプションと同じ）については以下のように配列で第二引数として指定します。指定できるのは以下の項目だけで、必要な項目だけを記述します。<br>以下のパラメータを第二引数として配列で指定する場合は、上記の第一引数が0であっても省略することはできません。-->
<p><?php _e( 'The last parameter "max_page_num" is not an option value. For example, when you get a list of the specific category post using the WP_Query at a "static" page, "$wp_query->max_num_pages" may not have a value. In that case, pagenation will be not displayed. You should be able to get the total number of pages somehow, so just specify that value in this parameter and it will work.', $this->domain ); ?></p>
<!-- パラメータの最後の'max_page_num'はオプション値ではありません。たとえば、固定ぺーじにおいてWP_Queryを使って特定のカテゴリとか投稿タイプとかの一覧をとるなどした場合など、$wp_query->max_num_pagesに値が無い場合があり、その場合にページネーションが機能しなくなります。何らかの方法で全ページ数を得てこのパラメータで指定します。-->
<pre>
if ( function_exists( 'splcpn_echopager' ) ) {
$args = array(
'reverse' => '0', // 0:normal( from left ) 1:reverse( from right )
'above' => '7', // Show jump-box when the total number of pages is more than this number, default:7
'minimum_unit' => '1', // 0:minimum-list 1:full-list
'adjacent_num'=> '3',// Number of pages that adjacent to current page to be displayed, 1-5
'larger_page'=> '3',// Number of pages that multiples of 10 to be displayed, 0-5
'top_label' => 'Top',
'last_label' => 'Last',
'connection_str'=>'~',// Connection string, empty is disable.
'div_id'=>'pagenavilist',// ID name of parent div tag.
'font_size'=>'0',//specify font size. set 0 to disable. -10 : 0.5em ~ 10 : 1.5em, at intervals of 0.05em.
'top_text_align'=>'0',// Text-align of id="toppagelink" of "nav" tag. 0 : disable, 1:left, 2: right, 3:center.
'top_margin'=>'',// Margin of id="toppagelink" of "nav" tag. Empty is disable, top:right:bottom:left. This value can have from one to four values same as the format of css.
'bottom_text_align'=>'0',// Text-align of id selector "bottompagelink" of "nav" tag. 0 : disable, 1:left, 2: right, 3:center.
'bottom_margin'=>'',// Margin of id selector "bottompagelink" of "nav" tag. Same as "top_margin".
'distant_num'=>'3',// Number of pages that multiples of 100 to be displayed when the wide distance from the edge label.
'max_page_num'=>$wp_query->max_num_pages,// The total number of pages. This value is required when value of $wp_query->max_num_pages is empty or disable.
);
splcpn_echopager( 0, $args );
}
</pre>
<p><?php _e( 'If you specify the parameters as the second argument, you can different display even in the same page.', $this->domain ); ?></p>
<!-- 配列にてパラメータを指定すれば、同ページ内であっても違う表示をさせることができます。 -->
<p><?php _e( 'In addition, when you want to change the style for each page, you set the "Load style sheet" option to 0 and call the function of "direct_splcpn_style" before wp_head () in header.php. You can specify the style sheet to be loaded for each page.', $this->domain ); ?></p>
<!-- また、ページによってスタイルを変えたい場合などは、オプションの「Load style sheet」を0にセットし、header.phpにおいてwp_head() よりも前に「direct_splcpn_style関数」を呼び出すことで、ロードするスタイルシートをページごとに指定することができます。-->
<p><?php _e( 'For example, if in the following manner, you can randomly change the style at each page.', $this->domain ); ?></p>
<!-- たとえば以下のようにすれば、ランダムにスタイルを変更することができます。-->
<pre>
<?php
if ( function_exists( 'direct_splcpn_style' ) ) {
$splcpn_num = rand( 1, 6 );
direct_splcpn_style( $splcpn_num );
}
wp_head();
?>
</pre>
</div>