https://github.com/sectsect/wp-split-single-page
Helpers to split single page with each array of custom field on WordPress.
https://github.com/sectsect/wp-split-single-page
array nextpage pagination single-page split wordpress
Last synced: about 2 months ago
JSON representation
Helpers to split single page with each array of custom field on WordPress.
- Host: GitHub
- URL: https://github.com/sectsect/wp-split-single-page
- Owner: sectsect
- License: mit
- Created: 2016-06-04T15:20:26.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2018-11-26T15:24:21.000Z (over 7 years ago)
- Last Synced: 2026-01-30T12:40:05.880Z (4 months ago)
- Topics: array, nextpage, pagination, single-page, split, wordpress
- Language: PHP
- Homepage:
- Size: 60.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 
WP Split Single Page
[](https://travis-ci.org/sectsect/wp-split-single-page) [](https://php-eye.com/package/sectsect/wp-split-single-page) [](https://packagist.org/packages/sectsect/wp-split-single-page) [](https://packagist.org/packages/sectsect/wp-split-single-page)
#### \- For Each Array of custom field -
### Supply some functions and Pagination for split single page for each array of custom field without `` on your template.
## Installation
##### 1. Clone this Repo into your `wp-content/plugins` directory.
```
$ cd /path-to-your/wp-content/plugins/
$ git clone git@github.com:sectsect/wp-split-single-page.git
```
##### 2. Activate the plugin through the 'Plugins' menu in WordPress.
That's it:ok_hand:
## Notes
- Supports `is_preview()` Page. See [Usage Example](#usage-example).
- Supports Wordpress Plugin [Public Post Preview](https://github.com/ocean90/public-post-preview)
- Supports Wordpress Plugin [CF Preview Fix](https://wordpress.org/plugins/cf-preview-fix/) for Cloudfront
:memo: You need to manually add the following two parameters to the URL output by CF Preview Fix.
```
&post_date=20171231021559&preview_time=20171231021604
```
## functions
| Function | Description |
| ------ | ----------- |
| `is_single_paged($num)` | Detect the specific splitted page number.
( Return: `boolean` ) |
| `single_paginate($args)` | Get the Pagination.
( Based on `paginate_links()` [Codex](https://codex.wordpress.org/Function_Reference/paginate_links) ) |
| `prev_single_paged_link($pagecount, $paged, $label, $type)` | Get the Previous Split Single Page link |
| `next_single_paged_link($pagecount, $paged, $label, $type)` | Get the Next Split Single Page link |
| `add_rel_prev_next_paginated_posts($pagecount)` | Get `rel="prev"` and `rel="next"` links
See [Indicating paginated content to Google](https://support.google.com/webmasters/answer/1663744) |
#### `single_paginate($args)`
Default Arguments
``` php
$args = array(
'base' => get_the_permalink() . '%#%/', // (is_preview()) get_the_permalink() . '&paged=%#%'
'format' => get_the_permalink() . '%#%/', // (is_preview()) get_the_permalink() . '&paged=%#%'
'total' => 1,
'current' => 0,
'show_all' => false,
'end_size' => 1,
'mid_size' => 2,
'prev_next' => true,
'prev_text' => __('« Previous'),
'next_text' => __('Next »'),
'type' => 'list',
'add_args' => false,
'add_fragment' => '',
'before_page_number' => '',
'after_page_number' => '',
);
```
**TIP:** `'base'` and `'format'` Silence is golden 👍
#### `next_single_paged_link($pagecount, $paged, $label, $type)`
##### Parameters
* **pagecount**
`(integer)` The total number of pages.
* **paged**
`(integer)` The current page number.
* **label**
`(string)` (Optional) Link text to display.
Default: `'Next'`
* **type**
`(string)` (Optional) Controls format of the returned value.
Possible values are:
- **'plain'** - `Next`
- **'list'** - `
Default: `'plain'`
#### `add_rel_prev_next_paginated_posts($pagecount)`
##### Parameters
* **pagecount**
`(integer)` The total number of pages.
## Usage Example
#### single.php
NOTE: Split the page by array (w/ [Custom Field Suite](https://wordpress.org/plugins/custom-field-suite/) Plugin).
``` php
get('page') ) );
}
?>
The first page only.
get('page'); // Get the array of Loop-field
$pages = array_values( (array) $pages ); // Reset array Keys
if ( ! is_preview() ) {
$paged = ( get_query_var('page') ) ? get_query_var('page') : 1;
} else {
if ( isset( $_GET['paged'] ) ) {
$pagenum = (int) wp_unslash( $_GET['paged'] );
}
$paged = ( $pagenum ) ? $pagenum : 1;
}
$pagecount = count( $pages );
$key = $paged - 1; // "-1" For Array's key
$page = $pages[$key];
?>
The last page only.
$pagecount,
'current' => $paged,
);
single_paginate($args);
}
?>
```
## Change log
* **1.4.0** - Specify canonical URL in canonical meta tag
* **1.3.0** - Add New function `add_rel_prev_next_paginated_posts()`
* **1.2.8** - Rename a function to `is_perm_trailingslash()`
* **1.2.7** - Improve some codes for comparing same types
* **1.2.6** - :bug: Fix bug in function `is_single_paged()`
* **1.2.5** - :bug: Fix bug for navigation links when the permalink setting has no Trailing Slash
* **1.2.4** - :bug: Fix PHP Notice for Undefined variable
* **1.2.3** - Add PHP Unit Testing w/phpunit via TravisCI
* **1.2.2** - Add support that permalink setting has no Trailing Slash. And Support Plugin [CF Preview Fix](https://wordpress.org/plugins/cf-preview-fix/) for Cloudfront (w/ conditions).
* **1.2.1** - Add composer.json
* **1.2.0** - Add Support Wordpress Plugin [Public Post Preview](https://github.com/ocean90/public-post-preview)
* **1.1.0** - Add New functions `prev_single_paged_link()` and `next_single_paged_link()`
* **1.0.0** - :tada: Initial Release
See [CHANGELOG](https://github.com/sectsect/wp-split-single-page/blob/master/CHANGELOG.md) file.
## License
See [LICENSE](https://github.com/sectsect/wp-split-single-page/blob/master/LICENSE) file.