247 lines
11 KiB
Markdown
247 lines
11 KiB
Markdown
|
# Infinite-Scroll #
|
|||
|
|
**Contributors:** beaver6813, dirkhaim, paul.irish, benbalter
|
|||
|
|
**Donate link:** http://www.infinite-scroll.com
|
|||
|
|
**Tags:** ajax, pagination, scrolling, scroll, endless, reading
|
|||
|
|
**Requires at least:** 3.2
|
|||
|
|
**Tested up to:** 3.5
|
|||
|
|
**Stable tag:** 2.6.2
|
|||
|
|
|
|||
|
|
Automatically append the next page of posts (via AJAX) to your page when a user scrolls to the bottom.
|
|||
|
|
|
|||
|
|
## Description ##
|
|||
|
|
|
|||
|
|
Infinite scroll has been called autopagerize, unpaginate, endless pages. But essentially it is pre-fetching content from a subsequent page and adding it directly to the user’s current page.
|
|||
|
|
|
|||
|
|
When a user scrolls towards the bottom of the page, the next page of posts is automatically retrieved and appended. This means they never need to click "Next Page", which *dramatically increases stickiness*.
|
|||
|
|
|
|||
|
|
Features:
|
|||
|
|
|
|||
|
|
* Works out-of-the-box for many popular WordPress themes -- just activate the plugin and scroll
|
|||
|
|
* Fully customizable to adapt to your site and theme
|
|||
|
|
* Requires no (hopefully) template hacking, only a knowledge of CSS selectors.
|
|||
|
|
* Relies on shared database of common themes to simplify installation process
|
|||
|
|
* Maintain local database of theme presets for all installed themes (shared across network on multisite installs)
|
|||
|
|
* Countless API endpoints to modify the behavior.
|
|||
|
|
* Backwards compatible: Will not break RSS readers, mobile devices, or browsers with javascript
|
|||
|
|
|
|||
|
|
Full information on [infinite-scroll.com](http://www.infinite-scroll.com)
|
|||
|
|
|
|||
|
|
## Screenshots ##
|
|||
|
|
|
|||
|
|
### 1. CSS Selector (theme) configuration options ###
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 2. Text and image options (to display as additional posts load) ###
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 3. Edit theme presets screen ###
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Changelog ##
|
|||
|
|
|
|||
|
|
### 2.5 ###
|
|||
|
|
* Plugin completely rewritten from the bottom up
|
|||
|
|
* **Note: you will need to manually reactivate this plugin after upgrading**
|
|||
|
|
* Minimum WordPress version required now to **3.2**
|
|||
|
|
* Added support for internationalization (see FAQ for information on translating)
|
|||
|
|
* Added support for custom post types (now works on all pages but `is_singular()`)
|
|||
|
|
* Options screens significantly simplified with additional help text
|
|||
|
|
* Presets screen now uses standard WordPress administrative interface
|
|||
|
|
* Ability to submit your theme's CSS Selectors to the community CSS selector database to aid others with installation
|
|||
|
|
* Changes to presets are now made inline; saved via AJAX without page reload
|
|||
|
|
* Added additional API endpoints for developers to modify and customize plugin behavior
|
|||
|
|
* Loading image now uses native WordPress uploader and can accept arbitrary URL or image from media gallery
|
|||
|
|
* Loading and finished text now uses native WordPress TinyMCE editor
|
|||
|
|
* If site administrator has not entered CSS selectors and preset is known, plugin will default to preset
|
|||
|
|
* Any preset entered by site (or network) administrator will now override community contributed presets by default
|
|||
|
|
* Community contributed CSS selector presets are now stored in the database allowing for plugin directory to be unwritable (security enhancement)
|
|||
|
|
* Prompts users to default to CSS selector preset when available
|
|||
|
|
* Presets now support child themes
|
|||
|
|
* Community contributed CSS selected asynchronously update daily (performance enhancement)
|
|||
|
|
* Site (or network) specific CSS selector presets are now stored in the database (security enhancement)
|
|||
|
|
* CSS Preset updater now uses WP_HTTP class (compatibility enhancement)
|
|||
|
|
* Javascript file now served directly to user (rather than proxied via PHP) to allow for browser caching, minification, serving via CDN, and better integration with caching plugins (performance enhancement)
|
|||
|
|
* Javascript options stored natively in database and passed directly to script via WordPress's `wp_localize_script` function (performance and customizability enhancement)
|
|||
|
|
* No longer relies on deprecated user levels to determine permissions
|
|||
|
|
* Default loading and fished messages changed
|
|||
|
|
* Fixes for error and warnings when run with `WP_DEBUG` enabled
|
|||
|
|
* Removed prompt for option to activate infinite scrolling for only certain users (defaults to all)
|
|||
|
|
* Removed prompt for option to toggle debug mode (defaults to `WP_DEBUG` or `SCRIPT_DEBUG`)
|
|||
|
|
* Removed prompt for option to toggle scrolling behavior (defaults to automatic)
|
|||
|
|
* Removed prompt for additional callbacks
|
|||
|
|
* Removed prompt to select image alignment (defaults to left, can override via CSS)
|
|||
|
|
* Significant code clean up, file reorganization, and in-line documentation to conform to WordPress coding and style standards (whitespace, double v. single quotes, tab drift, trailing commas, closing PHP tags, etc.)
|
|||
|
|
* Classes loaded as sub-classes (rather than extending parent class) to prevent classes from becoming out of sync
|
|||
|
|
* Added phpdoc style documentation
|
|||
|
|
* Plugin file name changed to conform to standard WordPress naming conventions
|
|||
|
|
* License (GPL) included with distribution
|
|||
|
|
* Version numbering simplified
|
|||
|
|
|
|||
|
|
### 2.0b2.120111 ###
|
|||
|
|
* Added infinite_scroll_load_override filter to manually force infinite-scroll to load on a page.
|
|||
|
|
* Thanks to https://github.com/samargulies for the above patch.
|
|||
|
|
|
|||
|
|
### 2.0b2.111218 ###
|
|||
|
|
* Updated preset DB with basic themes
|
|||
|
|
* Made a few fixes in options/presets to prep for main release.
|
|||
|
|
* Changed hook used by 404 detection to template_redirect from wp.
|
|||
|
|
|
|||
|
|
### 2.0b2.110822 ###
|
|||
|
|
* Removed registration/enqueuing script in favor of just enqueueing
|
|||
|
|
* Fixed bug/typo in compressed init script
|
|||
|
|
|
|||
|
|
### 2.0b2.110821 ###
|
|||
|
|
* Converted options pages to use Settings API
|
|||
|
|
* Added behavior selection (Manual triggering)
|
|||
|
|
|
|||
|
|
### 2.0b2.110818 ###
|
|||
|
|
* Completely revamped admin panel adding more modular management
|
|||
|
|
* Added ability to center loading image
|
|||
|
|
* Added WYSIWYG editor to HTML allowed fields in admin panel
|
|||
|
|
* Updated Javascript callback to pass DOM for new elements added
|
|||
|
|
* Added Preset manager
|
|||
|
|
* Added ability to auto-fill selector fields from theme preset
|
|||
|
|
* Overhaul of underlying code, separating out into classes to cut down
|
|||
|
|
on code processed (and hence load time) for the end-user.
|
|||
|
|
|
|||
|
|
### 2.0b2.110723 ###
|
|||
|
|
* Improved escaping on settings to allow greater flexibility.
|
|||
|
|
* Fixed issue with jQuery not loading if WP version is up to date.
|
|||
|
|
* Fixed issue with plugin showing twice on plugin list.
|
|||
|
|
|
|||
|
|
### 2.0b2.110716 ###
|
|||
|
|
* Moved init script from direct page insertion to separate script.
|
|||
|
|
* Cleaned up unneeded declared constants.
|
|||
|
|
* Combined init script and library into one minified script.
|
|||
|
|
* This fixes an incompatibility with HeadJS plugin.
|
|||
|
|
|
|||
|
|
### 2.0b2.110713 ###
|
|||
|
|
* Fixed multiple jQuery loaded conflicts.
|
|||
|
|
* Now uses standard WordPress javascript insertion.
|
|||
|
|
* Loads locally stored jQuery 1.6.2 if current version is < 1.6
|
|||
|
|
this can only be detected through WordPress now, hence the fix
|
|||
|
|
for multiple versions conflicting (some naughty themes don't
|
|||
|
|
use WordPress's javascript loading).
|
|||
|
|
|
|||
|
|
### 2.0b2.110709 ###
|
|||
|
|
* FIX: Default options not being recursively copied.
|
|||
|
|
* Updated to new options layout.
|
|||
|
|
* Callback fix.
|
|||
|
|
|
|||
|
|
### 2.0b2.110706 ###
|
|||
|
|
* HTTPS loading image fix.
|
|||
|
|
* Better debug support (switches between minified and non).
|
|||
|
|
|
|||
|
|
### 2.0b2.110629 ###
|
|||
|
|
* Callback (custom javascript) fix.
|
|||
|
|
* IE9 binding bug fix.
|
|||
|
|
|
|||
|
|
### 2.0b2.110628 ###
|
|||
|
|
* Modified the method used to determine the link paths (bug fix)
|
|||
|
|
|
|||
|
|
### 2.0b2.110617 ###
|
|||
|
|
* Updated core javascript to version 2.0b2.110617 (full revamp).
|
|||
|
|
* General cleanup/tidy of plugin itself.
|
|||
|
|
* Fixed bugs with numerical sub-domains (now uses site_url to determine path).
|
|||
|
|
* Supports archives, tags, searches.
|
|||
|
|
* Wider theme support.
|
|||
|
|
* Simplified plugin options page, added loading image upload ability, added option for debug mode.
|
|||
|
|
* Removed annoying reminder that showed on all admin pages.
|
|||
|
|
* Forces 404 header when no more posts are available.
|
|||
|
|
|
|||
|
|
### 1.5.100504 ###
|
|||
|
|
* New appending technique using document fragments.
|
|||
|
|
* Callback receives the contentSelector elem as its first argument,
|
|||
|
|
and an array of the new elements as the second argument
|
|||
|
|
|
|||
|
|
### 1.4.100210 ###
|
|||
|
|
Fixed small bug that jQuery 1.4 introduced.
|
|||
|
|
|
|||
|
|
### 1.4 ###
|
|||
|
|
Proper WordPress method (enqueue_script) removed because it just breaks too often
|
|||
|
|
JS updated with some custom method action.
|
|||
|
|
|
|||
|
|
### 1.3 ###
|
|||
|
|
Use proper WordPress function to register the javascript
|
|||
|
|
Use plugins_url to determine plugin url
|
|||
|
|
|
|||
|
|
### 1.2 ###
|
|||
|
|
* 2009 August 4th
|
|||
|
|
* `get_option('siteurl')` fix made.
|
|||
|
|
* jQuery plugin version updated. many more options available.
|
|||
|
|
* Release backwards compatible
|
|||
|
|
|
|||
|
|
### 1.1 ###
|
|||
|
|
* 2008 September 25
|
|||
|
|
* JavaScript rewritten as a proper jQuery plugin.
|
|||
|
|
* Added animation
|
|||
|
|
|
|||
|
|
### 1.0 ###
|
|||
|
|
* June 29 - 1.0 release.
|
|||
|
|
|
|||
|
|
## Frequently Asked Questions ##
|
|||
|
|
|
|||
|
|
### What exactly is infinite scrolling? ###
|
|||
|
|
|
|||
|
|
Essentially it is pre-fetching content from a subsequent page and adding it directly to the user’s current page. [More Information](http://www.infinite-scroll.com/the-interaction-design-pattern/)
|
|||
|
|
|
|||
|
|
### Can I change the number of posts loaded? ###
|
|||
|
|
|
|||
|
|
Yes. Go to Settings -> Reading in your WordPress administrative dashboard.
|
|||
|
|
|
|||
|
|
### How do I change the alignment of the loading image? ###
|
|||
|
|
|
|||
|
|
Add the following to your theme's css: `#infscr-loading img { text-align: ALIGNMENT; }` where "ALIGNMENT" is either `left`, `right`, or `center`.
|
|||
|
|
|
|||
|
|
### How can I pass additional arguments such as behavior or callbacks to the script? ###
|
|||
|
|
|
|||
|
|
Add a filter to `infinite_scroll_options` and adds additional options to the options array.
|
|||
|
|
|
|||
|
|
### Is the plugin available in my language? ###
|
|||
|
|
|
|||
|
|
If you enjoy the plugin and are interested in contributing a translation (it's super easy), please take a look at the [Translating WordPress](http://codex.wordpress.org/Translating_WordPress) page.
|
|||
|
|
|
|||
|
|
### Is it SEO-Friendly? ###
|
|||
|
|
Yes all enhancements are made via javascript only, so search spiders see no difference.
|
|||
|
|
|
|||
|
|
### Is it accessible? ###
|
|||
|
|
|
|||
|
|
Things won’t change for screen-readers. This technique degrades gracefully.
|
|||
|
|
|
|||
|
|
### Does it still keep going, even at the end of the blog? ###
|
|||
|
|
|
|||
|
|
Infinite scroll is configured to die when it hits a 404 Not Found status code, so when it goes through all your archives it should hit a /page/43/ (or something) that doesn’t exist, then show a message "Congrats, you’ve reached the end of the internet." Some WordPress themes don’t report not found pages with a 404. Try a different theme or contacting the theme author.
|
|||
|
|
|
|||
|
|
### Do I need to edit my theme to make this work? ###
|
|||
|
|
|
|||
|
|
Probably not, nope.
|
|||
|
|
|
|||
|
|
### How do I pass additional arguments such as callbacks to the Infinite Scroll script? ###
|
|||
|
|
|
|||
|
|
To pass additional arguments to the Infinite Scroll script, add the following code to either your theme's `functions.php` or to a stand-alone plugin file.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
function my_infinite_scroll_options_filter( $options ) {
|
|||
|
|
$options['callback'] = 'my_callback';
|
|||
|
|
$options['another_parameter'] = 'another_value';
|
|||
|
|
return $options;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
add_filter( 'infinite_scroll_js_options', 'my_infinite_scroll_options_filter' );
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Installation ##
|
|||
|
|
|
|||
|
|
### Automatic Install ###
|
|||
|
|
1. Login to your WordPress site as an Administrator
|
|||
|
|
2. Navigate to Plugins->Add New from the menu on the left
|
|||
|
|
3. Search for "Infinite Scroll"
|
|||
|
|
4. Click "Install"
|
|||
|
|
5. Click "Activate Now"
|
|||
|
|
|
|||
|
|
### Manual Install ###
|
|||
|
|
1. Download the plugin from the link in the top left corner
|
|||
|
|
2. Unzip the file, and upload the resulting "infinite-scroll" folder to your "/wp-content/plugins directory" as "/wp-content/plugins/infinite-scroll"
|
|||
|
|
3. Log into your WordPress install as an administrator, and navigate to the plugins screen from the left-hand menu
|
|||
|
|
4. Activate Infinite Scroll
|