To download and install you can either scroll down and find the download button at the bottom of this article, or you will soon be able to auto-install from the WP back-end.

Do be aware that this is quite a database heavy and complex plugin - it should work well on most installs, but it’s not for everybody and we hold no responsibility for any problems caused.  Consider taking a back-up before implementation.

The Techie Stuff, If You Need It…

This plug-in provides you with more relevant search results than are currently available to the normal Wordpress search and it should also do so with less of a performance hit on the db than the normal Wordpress search. Instead of the use of LIKE “%term%” we use the MySQL commands MATCH () AGAINST () to do our queries which are not as heavy on the db, the only issue we have with “match against” is that we need an index on the columns we intend to search on.

Installation

1. Upload “spec-adv-search” folder to “/wp-content/plugins/spec-adv-search/” or the content of the folder to “/wp-content/mu-plugins/”. If the directory doesn’t exist then create it.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. You should now see an extra control panel called “Advanced search” which will show up under the settings menu in the main admin sidebar.
4. You will need to go in and enable the plugin here before it takes over - otherwise you’ll just be using the old-style search.

Configuration

For these search methods to work we need a FULLTEXT index on your post_content and post_title in the wp_posts table. This is done by using the “create index” button. There are some things to be aware of before you proceed.

1. Adding the index will likely double the size of your wp_posts table, this in and of itself isn’t a problem however if you’re running up against the upper limits of your hosts allowed size then creating an index may push you over that limit. If you do hit your size limit nothing bad should happen but it would be best if you backed up your database first just in case. Always a good idea to run a backup before anything is done to change the db.
2. The index creation is handled by a Wordpress cron job, some hosts have problems with wp_cron and if your host is one of those then you will see this “The index creation/deletion is scheduled to start after {date and time}” below the button for a long time after the job was supposed to run. Don’t worry if it’s only a few mins as that is quite normal if you have a number of cron jobs ahead of it in the queue. If you do have a problem with wp_cron on your server you may also find future dated posts don’t become live when you hoped. There is an option to disable the use of cron toward the bottom of the page, if used you’ll have to do table optimisation manually. Or we can, if you have something like PHPMyAdmin, create the indexes manually by running these commands against your Wordpress db:

   CREATE FULLTEXT INDEX spec_post_content_fulltext ON wp_posts (post_content);

   CREATE FULLTEXT INDEX spec_post_content_fulltext_title ON wp_posts (post_title);

3. Creating the indexes could take quite some time depending upon your server set up, amount of content you have, the mood your server is in, the load on it and probably a load of other reason too. Once the index creation kicks in, unless your server creates the index so quickly that it completes the creation before the command to collect the status has run, you should see “Creating index on post_—–. MySQL is returning the following message:” Don’t panic if you see something like “repair by sorting” or “copy to tmp table” as these are expected messages but if you get “Repair with keycache” still don’t panic just be prepared to wait a long while for the index to complete its creation.

Once the index is live you should be able to tick the enable button. Now we get to choose from up to 5 different modes of search:

1. Default mode: This will find posts containing any of the term, the more of the terms there are in a post the higher relevance score it receives and thus the higher in the results it will appear (presuming sorting by rank). If two or more terms are searched for but only one can be found then posts matching that one will be returned. Terms matched in titles count as one and a half as much as those in the content.
2. Boolean mode: Very much the same as default mode but you get several extra operators that can alter a query. Adding + or – to the head of a term will either make it so that you return posts that must have the term or must not have the term. > or < will increase or decrease the importance of a word. So for example (phone >droid) would find all phone post and droid post but droid posts would be considered more important. A full explanation of the operators can be found here.
3. With query expansion: This kind of search can find posts related to your search terms but don’t necessarily contain any of the terms entered. So search for “android” for example and it will use posts that contain the word android to find words that are related to it. So it may deem that you want posts about robots too or it may also figure you want post relating to Google’s phone OS it really depends upon your sites content. For this mode you’ll need to tweak the relevance limit bases on what has been returned for your content otherwise it can end up returning all posts on your site. Not too big a problem if ordered by relevance but if ordered by date your results will make no sense at all.
4. In natural language mode: If you have MySQL 5.1 or better you will have two more modes available to you. First is In natural language mode which is mostly the same as default mode and in natural language more with query expansion which is functionally the same as the with query expansion.

If your server works with wp_cron then you can set up a periodic table optimise that will help keep your table index in order. If your site changes rarely then you can set it to run infrequently or not at all and just use the “optimise table” button to do it as and when you want/need to. The more accurate your index is the better your search results will be and the lower the load on the db. All good basically. The optimise will kick in after the time it is set to run but wp-cron requires a visitor to kick off the job. So if you set it to start at 3:00am and you don’t get an activity on your site until 10am the next day the job won’t start until 10am. This shouldn’t be a problem as most optimisations apply very little load and take only a few second to run.

Something to know.

With query expansion mode you can sometimes return some odd results, especially on a smaller dataset. This mode guesses what the searcher was after from words MySQL thinks are related to the terms searched for. If your content implies an association between two otherwise unrelated terms then MySQL will make an assumption that they are related. For example if you mention Ducks and Strawberries together in a few post your index will see a relationship and searches for Ducks may return results for Strawberries.

Download Plugin

This could also be useful for theme builders as you’d not have to worry about your comments.php again, Comments.php is one of the more complicated elements of any theme. And don’t worry about only being able to use the stylesheets provided or having to hack the plug-in after every update, I’ve included three filters to allow you to replace the jQuery and the stylesheet with something of your own.

The filters

1. spec_comment_css This will pass the URL of the stylesheet through to your function to replace with your own file.
2. spec_comment_js The will pass the URL to the jQuery file that controls the roll up and a few other elements.
3. spec_comment_local_js This will pass in an array of localisation strings that are passed to the jQuery code.

To replace the CSS file you could add something like the following to your functions.php that would point to a comments.css file in the folder of your current theme.

<?php
add_filter('spec_comment_css', 'my_css_file');

function my_css_file() {
return get_bloginfo('template_directory') . '/comments.css';
}

?>

Warning
Some themes will fail to work with this without you doing something to them first. Such as if the theme doesn’t call the comments.php using the comments_template(); template tag or if your theme deals with comments in an unusual way, such as placing them in a sidebar or calling them in using Ajax. A missing or unusual DOCTYPE could cause problems too, in fact there are lots of things that could cause strangeness. However with most of the themes I’ve tested this with it has worked without issue straight out of the gate and even if it doesn’t look right you need only disable the plug-in to go back to how things were so nothing lost.

The install

1. Upload {commenting.php} and all sub folders to {/wp-content/plugins/spec-comments/} or {/wp-content/mu-plugins/} directory. If the directory doesn’t exist then create it.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. You should now see an extra menu called comments show up under the appearance menu in the main admin sidebar.
4. Check a page on your site with comments and see that everything is as you’d hope.  If it’s not then proceed to the config menu and see if what you want can be set from there.

The config

1. The main option with this plug-in is the option to define at which point the comments roll up. Default is set so that all replies are hidden behind a click but with the drop down you could specify that replies to replies are hidden or replies to replies of replies and so on…
2. The next group of options are some simple toggles and the first of these lets you turn off the plug-in’s CSS file. This can be handy if you want to keep all CSS in the one stylesheet thus reducing the number of HTTP requests or if you just want to style it up in your own way. If you turn off the style anything attached to the spec_comment_css filter will fail to run also.
3. As an extra to the one above we have the option to turn on the dark version of the comments. This is handy if your theme is, well err.., dark.
4. If you’d rather drop all the javaScript then the next option is for you. Be warned however that this will cause some styling issues in IE6 as jQuery is used to add some extra classes to items that would otherwise be inaccessible to IE6’s limited understanding of CSS. All other browsers are unaffected and IE6 will still be in a perfectly acceptable state it just won’t look the same as the other real browsers. Much the same as for the CSS, if you turn it off anything attached to the spec_comment_js or spec_comment_local_js filter will not be run.
5. The final option is to hide our credit link and is one we’d rather you didn’t do anything with but we’ve given you it anyway as we’re nice like that. We do understand that sometimes clients want things like that gone we’d just like to ask in return for that is that you think about signing up with us

^*Frequently Asked Questions

Why doesn’t it quite look/work right? Unfortunately it’s not possible for us to check this code against every theme out there so from time to time you may run into some incompatibilities. It’s possible that some CSS in your theme’s style.css is causing issues. You could try stripping out all commenting related CSS from it and see if that makes any difference. If it’s not that then it might be that your theme isn’t calling comments_template() to add the comments code, if that’s the case then you’re out of luck unless you know where to look in the theme code or you can get your theme developer to change their theme.

^*Well questions that I think might be frequently asked.

Download Plugin

Anyway, this always presented a problem for those of us migrating WordPress databases or even, just needing to do a quick search and replace across the entire database. For example, you might have moved office and wish to change all instances of your phone number on a website. It could be mentioned in a lot of posts, and in plugin settings.

And that’s why we wrote this little utility. In this incarnation if you drop it into your root folder it will pick up the WordPress DB connection settings, but if you wish to play safe and run the code elsewhere you’ll have to go into the code and set these yourself.

Ultimately you do have to be careful. This code can seriously damage the health of your database. It will cheerfully spend just a few seconds reducing your settings to rubble. So make sure you BACKUP FIRST!

To see how you can use this tool to aid migrations, check out the Interconnect IT article on WordPress migrations.

If you are in any doubt whatsoever about how to use this plugin, then please consider getting an expert in. You could even contact us over at Interconnect IT.

Download

It’s often nice to be able to create a profile page or similar, and to display it in a sidebar. You get to use the visual editor, and you don’t necessarily need admin access. Similarly, you avoid the issue of having to work with the much more difficult text widget.

Downsides include that the theme may not have CSS styles properly set, so for example a captioned image may not display correctly. You should test this widget with your theme, across several browsers, before using it on a critical live site.

Installing the Plugin

You should use either use the WordPress built-in plugin installation process, or download the zip file of the plugin, unzip it, and copy it into your wp-content/plugins folder.

Activating the Plugin

Sign in to the back-end of your WordPress administration (usually your site’s main address plus /wp-admin ) and navigate to Appearance | Plugins | Installed.

Activating the Plugin, 2

In the main part of the Manage Plugins page, you should now see the Spectacu.la Page Widget in grey. Click on the activate text to activate the widget. Once activated the line for the plugin will change to white.

Using the Widget

We’re going to add a box to the top right of our WordPress site, showing the About page with an image.

Setting up Widgets

Navigate to Appearance | Widgets. In this panel you can control the widgets displayed on your site. You may need to add the Search, Pages, Archives and Categories widgets if you’re on a new install of WordPress. In this example they are already set up.

Drag the Spectacu.la Page Widget across as shown above. Be aware that it may be in a different position to that shown above.

Configuring the Widget

This is a powerful widget with a lot of options:

1. The page to show in the widget
2. Whether or not to show the title of the page
3. You can link to the source page - especially useful if you’re using the excerpt functionality
4. You can override the title and set something of your own
5. You can use an excerpt instead of the full content. The excerpt will be auto-generated unless you use Westi’s PJW Page Excerpt plugin which will allow you to create your own excerpt should you wish.
6. You may wish to hide this page from your site’s normal navigation. This may not work with some themes and plugins which don’t use conventional approaches to listing pages.

Set the options as in the image above, then click save.

Now let’s take a look at what’s happened.

The Result

As you can see, the sidebar now contains the entire content of the page, and the page has been removed from the navigation. Edit the post, and add a thumbnail aligned to the right…

With an Image

As you can see, there isn’t much space for even a thumbnail in this theme’s sidebar, but don’t let that put you off, you can change the size easily in WordPress, although that’s a different lesson. Have you seen our WordPress User Guides?

With a Smaller Image

And there he is - all right-sized and everything. Advanced WordPress users and designers will be able to make considerable use of this plugin, and basic users should be able to easily create well formatted and attractive sidebar content. If you have feedback on this plugin, feel free to comment here. If you need support, or simply wish to encourage us to release more plugins then you’ll need to join the (very reasonably priced) club.

Download