WordPress homepage settings trick: a simple, portable way to show a static homepage and a blog index
Posted: June 4, 2013 Filed under: WordPress Leave a comment »I’m sure there are quite a few ways to do this, but here’s the problem I recently encountered, and a solution.
I wanted to make an entirely portable theme with a non-standard (meaning not just a blog list) homepage, and a blog archive page (ie — an archive of all my posts) at a particular non-root URL — in my case http://www.something.com/blog. I think this is a pretty common scenario, and the usual way to deal with it is to use the settings under Settings -> Reading -> Front page displays:
So you’d create a couple pages, perhaps named “home” and “blog”, and use these and the home.php and front-page.php templates to create the desired effect. But this solution did not make me entirely happy for a couple of reasons:
- I find WordPress’ behavior under various combinations of these settings and various presences/absences of theme templates to be overly-complicated. As you can see from reading about these settings, there are several combinations of conditions that can obtain, and the template cascade becomes a bit hard to describe in general.
- Perhaps more importantly, I was going for portability here and did not want to require the presence of particularly-named pages for my URLs to work. (Nor did I want the theme to create these pages on install — problems abound with that.)
Instead, I came up with the following solution, which I’m sure is not unique, but I’m quite sure is not really that well known. (I’ll also note loudly that from a performance and technical point of view, it’s entirely possible that this technique may have various dark cosequences, and I welcome comments to that effect if I’ve overlooked something.)
So here’s how to do this:
1. Leave the Front Page setting on “your latest posts“.
2. Include a front-page.php template in your theme. This will always display when WordPress thinks you want the homepage. In this template include the markup etc. for your homepage.
3. Now the fun begins. We need to trick WordPress into showing us the blog index page on a URL without using a page. In my case, I use archive.php for listings like this, but in your case it might be something else, like index.php or whatever. In functions.php, add the following code:
//set blog_index as a valid query variable
function add_blog_index_var( $v ) {
$v[] = 'blog_index';
return $v;
}
//use the archive template whenever blog_index is set
function set_blog_index_template() {
if( get_query_var( 'blog_index' ) ) {
include( get_template_directory() . '/archive.php' );
exit();
}
}
//rewrites for blog index
add_rewrite_rule('blog/?$', 'index.php?blog_index=1', 'top');
add_rewrite_rule('blog/page/?([0-9]{1,})/?$', 'index.php?blog_index=1&paged=$matches[1]', 'top');
//add filter for query var
add_filter('query_vars', 'add_blog_index_var');
//add action for template swap
add_action( 'template_redirect', 'set_blog_index_template' );
So what does this do?
We first write the add_blog_index_var to add the blog_index variable as a valid query var that will be retrievable by get_query_var() and set-able from the URL. This addition is done below by filtering add_blog_index_var. This is a required internal mechanism that WordPress uses to regulate what variables can make the leap from $_GET to the WP_Query object.
We then write a function called set_blog_index_template that forces the archive.php template to be used if the blog_index query var is set. This function is then attached to the action hook template_redirect.
The only thing left to do is to force WordPress to set this get variable at a particular URL … hence the two calls to add_rewrite_rule … one for /blog/ (in my case … it could be any URI for you) and one for pagination like /blog/page/2/ etc.
Remember to flush rewrite rules before expecting this to work. (See Daniel Bachhuber’s excellent Rewrite Rules Inspector plugin if you need to sort out just what’s going on with your rules.
I hope this is useful to someone out there — it took me a while to figure out a decent way to do this without supporting special pages or futzing too much with the homepage settings.
CodeWithMe Portland
Posted: May 4, 2013 Filed under: Whatever Leave a comment »So I’m at code with me in Portland this weekend. Code with me is a great organization run by Tom Giratikanon and Sisi Wei that pairs technologists and journalists to spread the foundations of HTML, CSS and JavaScript. Here’s a picture of everyone in the big (windowless) conference room at the Oregonian.
To understand what a dedicated group this is, you should probably also check out the current weather in Portland, which is — to say the least — spectacular.
Events like this (in foul weather or fair) are really exciting. You’d think there would be more opportunities for journalists and technologists to not only spend time together, but also trade knowledge and work together. But really opportunities like these (open, learning, semi-structured events with lots of project time) are pretty rare, and I’m grateful to be involved this weekend. I’m also psyched to be working with two journalists: Evonne Benedict of King5 TV in Seattle and Rachel Alexander of Whitman College and Union-Bulletin News. Much fun!
Annoying Robots and the Chameleon Botnet
Posted: March 20, 2013 Filed under: Whatever Leave a comment »Yesterday Spider.io announced the discovery of the Chameleon Botnet, a mega-collection of infected Windows machines, based largely in the US. The purpose of the botnet is/was to generate large amounts of distributed, hard-to-detect traffic over sites displaying certain ads (or ads from certain networks), thereby generating bogus income via a network of 202 bogus content sites and defrauding advertisers out of something like $6 million/month. The characteristics of the traffic of this botnet are suspciously similar to the sort of traffic I wrote about over a year ago when I worked at Grist. In particular, the traffic instantiates JavaScript, identifies itself using a particular windows user agent, and is extremely homogeneous — which is basically what we saw at Grist. The Chameleon traffic differs in that it evidences real but apparently random mouse and click events:
Random distribution of clicks and mouse traces over a square ad on an infected site: image: spider.io
… and apparently were confined to the part of the screen containing the ad.
We’ll probably never know if the Grist phenomenon was of this sort, but I think it might be worth developing some sort of detector for botnets of this type if the possibility exists that they are affecting more than the small number that Spider.io’s report implies are affected by Chameleon. It would seem to me that botnets of this sort have both an incentive and a disincentive to include non-target sites on their hitlist. The incentive is simply that by including legitimate targets they obfuscate their scheme from advertisers to some extent (though it’s unclear if most advertisers directly review the distribution patterns of their ads through networks.) The disincentive is that targeting legitimate sites carries a risk of detection, though most sites would probably not notice if this were to start happening.
This was of great interest to me (and should really be to anyone who runs a site with significant traffic) because it’s the first public announcement of a botnet capable of running a complete client stack.
I would think that some analytics and advertising platforms like Google would be interested in understanding phenomena of this type better –I’d appreciate any links or info regarding countermeasures or detection of stuff like this.
How to make EE Fast(ER)
Posted: September 13, 2012 Filed under: ExpressionEngine 2 Comments »Tonight I’m talking to the cool-ass Seattle Expression Engine meetup about how to scale EE sites. It’s a bit of a quick tour of the subject, but I hope people find it useful. If you want to download the slides from this (.pdf) you can do so here. By the by, how much do I wish someone had written and add-on for EE like CE-cache a few years ago , when it was desperately needed at Grist …
A big change
Posted: September 4, 2012 Filed under: announcements 6 Comments »For those of you who know me reasonably well, you’ll know that I really love what I do.
I love building stuff online, learning new technologies, thinking up new ways to cause change on the web. The fact that for the last four years I’ve been able to do pretty much all of this, all the time, in my work at Grist is something that fills me with a great deal of gratitude. Any list of people who have impacted me in my time at Grist will be incomplete (and so I’m loathe to even try) but I’d be totally remiss if I did not mention both the amazing mentors I’ve had here. These include folks like Scott Rosenberg, Rebecca Farwell, Lori Schmall, and (going a few years back) Dean Ericksen. And then there are the people I’ve been privileged to work with every day — Nathan Letsinger, Hanna Welch, and (more recently) Mignon Khargie and Mr. Ben Brooks. And then there’s Chip Giller, founder and CEO of Grist, and a person whose generosity, vision and faith have benefited me in many ways.
On September 13, I will be moving on from Grist to a new and totally amazing challenge at MoveOn.org. It involves lots of work with technology, data and audience-building. It’s a daunting, but also very exciting challenge for me, and I promise to post more about that soon.
Right at this very moment, however, I’m thinking a lot about how I can remain connected to Grist in the future — as a fan, a reader, a community member, a friend, a (small-time) donor and (if they’ll let me) interloper at the Owl and Thistle Pub.
Twitter’s new API policy in plain english
Posted: August 16, 2012 Filed under: Whatever Leave a comment »
Twitter announced new API policies for version 1.1 of their API today. The announcement was accompanied by a diagram which IMHO was bit hard to understand at first and caused a bit of useless debate and worry on Twitter. Here’s my dumbed-down version of the diagram, or at least my understanding of it. The x axis represents who your application is for: the general public or, for lack of a better word, nerds (developers, business owners etc.) The y axis represents what your application allows those people to do: either count stuff (tweets, links etc etc.) or do stuff (tweet, search, etc etc)
Here’s Twitter’s (better) version of this:
Grist at WCSF12
Posted: August 2, 2012 Filed under: Whatever 2 Comments »
This weekend the some of team Grist will be in SF for WordCamp. I’m really excited to get to give a talk about our journey to becoming a WordPress operation. This year (in fact, almost exactly this year, as WCSF11 represented a bit of an introduction to WordPress for us) has been a huge adventure — we learned lots about the WordPress API, moved our content and hosting to a new platform, adopted a new operating model, developed a theme and began to seriously grow our audience.
[UPDATE]
Here’s dump of the slides I used in this presentation. Please feel free to hit me up on twitter with any questions or to talk about any of this.
