Description
When your blog is loaded, all links of this class .more-link (standard wordpress css class for “Read more…”
links) are modified to no longer send the user to that post’s
single page display when clicked. Instead, the WordPress database is queried for that specific post, and all content
after the <!–more–> tag (i.e. only what you need) is returned.
The new content is then immediately displayed to the user with light animation (You can disable animation in plugin options),
inline with the opening content.
- AJAX-read-more uses the jQuery framework already included with WordPress installations.
- This plugin used GET ajax action (not POST, like other plugins), wordpress “template_redirect” action.
- It’s compatible with cache plugins (like Hyper Cache Extended).
- AJAX-read-more: design of progress indicator and other behaviors – by CSS (example – in css/all.css)
- cache-safe script and css url
Check plugin options on options page.
Thanks for debugging to den@10-13.ru.
Theme requirements:
- Your theme must generate correct DOM structure:
(div id=”#content”)
…
(div class=”post”)
…
(/div)
(/div) - Theme must support footer (wp_footer). If not, you can change corresponding option on plugin option page.
For more information, please visit the Sergey S. Betke blog.
ToDo
The next version or later:
* wordpress core integration for cache headers processing???
* optional http cache-control max-age header value and must-revalidate
* just private cache headers, when post has limited access
* check cache plugins support (Hyper Cache Extended): clear cached responces when post modified
* cache-control and Last-Modification headers – to separate plugins
* if-modified http request support (separate plugins)
* the_excerpt optional support
* AJAX-read-more send correct http cache-control headers, and fully support client-side public cache.
* WP 3.3: http://wpdevel.wordpress.com/tag/3-3-dev-notes/
* WP 3.3: replace wp_localize_script() with wp_add_script_before(). wp_localize_script doesn’t support non-string params in WP 3.3+
* WP 3.3: wp_enqueue_script() now works mid-page – insert scripts just into pages when it’t needed
Screenshots
Site page with ajax loading indicator.
Installation
Simple:
- Upload the
AJAX-read-moredirectory (“unzipped”) to the/wp-content/plugins/directory - Find “AJAX Read More” in the ‘Plugins’ menu in WordPress and click “Activate”
- PHP 5.2
- Your theme must generate correct DOM structure:
(div id=”#content”)
…
(div class=”post”)
…
(/div)
(/div) - Theme must support footer (wp_footer). If not, you can change plugin options on options page.
That’s It!
FAQ
- Requirements?
-
Just read “installation” section.
- How do I change the “loading” image?
-
Change CSS rules for class “loading”. Example – screen.css.
The “loading” image used to visually inform the user that the new content is arriving was created using the excellent Ajax Load website.
To use a different image you can create a new one, name it “ajax-loader.gif”.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“AJAX Read More” is open source software. The following people have contributed to this plugin.
Contributors
Translate “AJAX Read More” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.1.1
- fixed PHP debug notices
- fixed non-critical errors
2.1.0
- change wp action to template_redirect action
- http cache control headers removed (this is task for wordpress and another plugin)
2.0.6
- removed additional header generation for 404 (wordpress did it self – see handle_404)
- removed extra headers (Cache-Control) – there task is task for web server config or for cache wordpress plugins
2.0.5
- css url versioning for cache updating
2.0.4
- fixed cache HTTP headers for AJAX responses
2.0.3
- animation cosmetic improvements
2.0.2
- fixed browser reflow process after plugin animation
2.0.1
- fixed cached responces for old version
2.0.0
- themes compatibility: removed .more-link-container
1.10.0
- animation option: scrollable container selection – parentScrollableEl (default – “html,body”)
1.9.6
- critical, fixed AJAX response parsing IE8 compatibility
1.9.5
- critical, fixed AJAX response parsing errors
1.9.4
- non critical, fixed AJAX response parsing
1.9.3
- cosmetic: i use get_the_content stripteaser=true
1.9.2
- search pages support
1.9.1
- fixed error (for non Windows OS) – fixed error on AJAX response (changed ‘\’ to ‘/’ in file paths, sorry)
1.9.0
- animation option: scroll to post header or to post content after excerpt – scrollToSelector (default – .entry-header)
1.8.0
- animation option: loadingClass (default – .loading)
- animation option: errorClass (default – .loading-error)
- animation option: animateSpeed (default – ‘slow’)
1.7.0
- option: custom error message
1.6.0
- animation option: full block scrolling
1.5.1
- jQuery safe mode support
1.5.0
- animation option: block scrolling when scroll less to XXX pixels
1.4.2
- fixed – error on options page (changed ‘\’ to ‘/’ in file paths, sorry)
1.4.1
- downgrade to PHP 5.2
- options page
1.3.1
- without lambda functions (for PHP 5.2- compatibility).
1.3.0
- lambda functions used
1.2.3
- workaround for non XML AJAX response
1.2.2
- correct detection of title of ajax loaded content
- ajax response parsing by $.parseXML
1.2.1
- special counter event triggered when ajax query succeded:
trigger(‘hit.counter’, {url: dt.url, title: dt.title, referer: dt.referer, params: {} })
1.2.0
- it’s beta version with xhtml formatted AJAX response. It’s first step for counters hit method support.
1.1.4
- when (div id=”content”) is missing, (body) element used.
1.1.3
- all file names – in lower case (for linux hosted sites).
- when wordpress theme does not produce (div class=”post”) wrapper,
window scrolled to .entry-part element (post excerpt in our case)
1.1.2
- AJAX responces sanitized (just force_balance_tags()).
- Stripped empty (p)(/p) tags.
1.1.1
- Some adaptions for standard wordpress themes.
1.1.0
- Now jquery.ajax.readmore is ready for AJAX’ed paged arhives.
- Changed DOM structure for excerpt and seque.
- Changed some animation.
1.0.0
- Initial Release + onupdate custom jQuery event.