Difference between revisions of "Code4Lib Journal WordPress Customizations"

From Code4Lib
Jump to: navigation, search
(Presentation)
Line 1: Line 1:
 
==Plugins==
 
==Plugins==
 +
 
===Anti-Spam===
 
===Anti-Spam===
 
;[http://akismet.com/ Akimset]
 
;[http://akismet.com/ Akimset]
 
:Filters out spam-link comments based on their content
 
:Filters out spam-link comments based on their content
;[http://recaptcha.net/plugins/wordpress reCAPTCHA] - disabled - there were accessibility issues
+
;[https://github.com/blaenk/wp-recaptcha WP-reCAPTCHA] - disabled - there were accessibility issues
 
:Requires users to copy a distorted word before they can comment
 
:Requires users to copy a distorted word before they can comment
  
 
===Metadata===
 
===Metadata===
;[http://www.wallandbinkley.com/quaedam/ COinS Quicktags Button]
+
;DOAJ Export
:In the non-WYSIWYG editor, can be used to build a basic COinS tag. This has been abandoned in favor of the generator at http://generator.ocoins.info/.
+
:Provides information about your posts formatted according to the DOAJ Article XML Schema. (J. Brinley)
 
;[http://www.lackoftalent.org/michael/blog/unapi-wordpress-plug-in/ unAPI Server]
 
;[http://www.lackoftalent.org/michael/blog/unapi-wordpress-plug-in/ unAPI Server]
:Provides information about articles. Useful for Zotero users.
+
:Provides information about articles. Useful for Zotero users. (M. Giarlo)
 +
;[http://www.wallandbinkley.com/quaedam/ COinS Quicktags Button] - no longer installed; buggy
 +
:In the non-WYSIWYG editor, can be used to build a basic COinS tag. This has been abandoned in favor of the generator at
 +
http://generator.ocoins.info/.
  
 
===Presentation===
 
===Presentation===
Line 17: Line 21:
 
;C4LJ Custom the_author()
 
;C4LJ Custom the_author()
 
:Replaces the text returned by the_author() with the value of the "author" custom field. Necessary since articles are entered by their editors, but we want author information to appear on the articles and in the syndication feeds.
 
:Replaces the text returned by the_author() with the value of the "author" custom field. Necessary since articles are entered by their editors, but we want author information to appear on the articles and in the syndication feeds.
;C4LJ Permissions
+
 
:Lets authors see pending posts.
+
===User Feedback===
;C4LJ Remove Parents
+
;[http://contactform7.com/ Contact Form 7]
:Remove parent directories & "category" from category permalinks.
+
:Email contact form plugin.  
 +
;[http://www.callum-macdonald.com/code/wp-mail-smtp/ WP-Mail-SMTP]
 +
:Reconfigures the wp_mail() function to use SMTP instead of mail() and creates an options page to manage the settings.
  
 
===URLs===
 
===URLs===
 
;C4LJ Remove Parents
 
;C4LJ Remove Parents
:A customization of http://wordpress.org/extend/plugins/remove-parents/. Prettifies category URLs so that issues appear at <code>http://journal.code4lib.org/issues/issue1</code> instead of <code>http://journal.code4lib.org/issues/issues/issue1</code>.
+
:A customization of http://wordpress.org/extend/plugins/remove-parents/. Prettifies category URLs so that issues appear at <code>http://journal.code4lib.org/issues/issue1</code> instead of <code>http://journal.code4lib.org/issues/issues/issue1</code>. (J. Brinley)
 
;[http://www.feedburner.com/fb/a/help/wordpress_quickstart FeedBurner FeedSmith]
 
;[http://www.feedburner.com/fb/a/help/wordpress_quickstart FeedBurner FeedSmith]
 
:Redirects the main feed and the general comments feed to FeedBurner
 
:Redirects the main feed and the general comments feed to FeedBurner
Line 30: Line 36:
 
===Workflow===
 
===Workflow===
 
;[https://github.com/code4lib/c4lj-issue-manager Issue Manager]
 
;[https://github.com/code4lib/c4lj-issue-manager Issue Manager]
:Enables one-click publishing of new issues, and prevents articles from being published until their associated issue is published.
+
:Enables one-click publishing of new issues, and prevents articles from being published until their associated issue is published. (J. Brinley)
 +
;[http://wordpress.org/extend/plugins/revision-cleaner/ Revision Cleaner]
 +
:Auto clean your revisions that you don't needed any more.
 
;[http://www.im-web-gefunden.de/wordpress-plugins/role-manager/ Role Manager]
 
;[http://www.im-web-gefunden.de/wordpress-plugins/role-manager/ Role Manager]
 
:Allows creation of custom roles and editing of roles' permissions. Used to create the Reviewer role, which can read Private articles, so that authors can see their articles before publication, and to prevent editors from publishing articles on accident.
 
:Allows creation of custom roles and editing of roles' permissions. Used to create the Reviewer role, which can read Private articles, so that authors can see their articles before publication, and to prevent editors from publishing articles on accident.
 +
;C4LJ Permissions
 +
:Lets authors see pending posts. (J. Brinley)
 +
;C4LJ Remove Parents
 +
:Remove parent directories & "category" from category permalinks. (J. Brinley)
 +
;Remove Special Word Characters
 +
:Replaces special characters copied from MS Word with their entity equivalents. (J. Brinley)
  
 
==Upgrading==
 
==Upgrading==
 
These fixes were necessary for WP < 2.5, but should not be needed any longer.
 
 
===Save the &lt;div&gt;s===
 
Edit wp-includes/js/tinymce/tiny_mce_config.php, around line 25.
 
$valid_elements = '-strong/-b[*],-em/-i[*],-font[*],-ul[*],-ol[*],-li[*],*[*]';
 
  
 
==="Submit for Review"===
 
==="Submit for Review"===

Revision as of 13:43, 5 May 2014

Plugins

Anti-Spam

Akimset
Filters out spam-link comments based on their content
WP-reCAPTCHA - disabled - there were accessibility issues
Requires users to copy a distorted word before they can comment

Metadata

DOAJ Export
Provides information about your posts formatted according to the DOAJ Article XML Schema. (J. Brinley)
unAPI Server
Provides information about articles. Useful for Zotero users. (M. Giarlo)
COinS Quicktags Button - no longer installed; buggy
In the non-WYSIWYG editor, can be used to build a basic COinS tag. This has been abandoned in favor of the generator at

http://generator.ocoins.info/.

Presentation

SyntaxHighlighter Evolved
Post syntax-highlighted code.
C4LJ Custom the_author()
Replaces the text returned by the_author() with the value of the "author" custom field. Necessary since articles are entered by their editors, but we want author information to appear on the articles and in the syndication feeds.

User Feedback

Contact Form 7
Email contact form plugin.
WP-Mail-SMTP
Reconfigures the wp_mail() function to use SMTP instead of mail() and creates an options page to manage the settings.

URLs

C4LJ Remove Parents
A customization of http://wordpress.org/extend/plugins/remove-parents/. Prettifies category URLs so that issues appear at http://journal.code4lib.org/issues/issue1 instead of http://journal.code4lib.org/issues/issues/issue1. (J. Brinley)
FeedBurner FeedSmith
Redirects the main feed and the general comments feed to FeedBurner

Workflow

Issue Manager
Enables one-click publishing of new issues, and prevents articles from being published until their associated issue is published. (J. Brinley)
Revision Cleaner
Auto clean your revisions that you don't needed any more.
Role Manager
Allows creation of custom roles and editing of roles' permissions. Used to create the Reviewer role, which can read Private articles, so that authors can see their articles before publication, and to prevent editors from publishing articles on accident.
C4LJ Permissions
Lets authors see pending posts. (J. Brinley)
C4LJ Remove Parents
Remove parent directories & "category" from category permalinks. (J. Brinley)
Remove Special Word Characters
Replaces special characters copied from MS Word with their entity equivalents. (J. Brinley)

Upgrading

"Submit for Review"

Edit wp-admin/includes/post.php. After line 71 (in version 2.3.3) add:

// START FIX
if ('publish' == $_POST['post_status'] && !current_user_can( 'publish_posts' )) {
	$post =& get_post( $post_ID );
	if ('publish' != $post->post_status)
		$_POST['post_status'] = 'pending';
}
// END FIX

Issue Manager Plugin

To Publish an Issue

  1. Assign timestamps to the articles in the order you want them to appear on the page (newest timestamps go at the top of the page)
  2. Go to the Issue Manager page in the "Manage" tab.
  3. Click "Publish" next to the category for the issue you want to publish.
  4. All "Pending Review" articles with the given category (that don't also have an "unpublished" category) will be published, with the timestamps updated to about now, retaining the order established earlier.

To Prevent Early Publication of Articles

  1. Go to the Issue Manager page in the "Manage" tab.
  2. Click "Unpublish" next to the category for the issue you want to keep unpublished.
  3. Any published articles with that category will revert to "Pending Review" status. Any new articles you attempt to publish will instead be set to "Pending Review".

Google Code Repository

The theme and plugins used by the Journal are available via Google Code. Some of the plugins are described on Jonathan Brinley's blog.