Changelog

1. FIX: Shortcodes within an inlined post are now processed. Uses do_shortcode().
2. FIX: Comment metadata now shows correct number of comments made.
3. NEW: Change code convention to shortcode which allows use of the standard shortcode functions. Old insert methods are deprecated but will still work.
4. NEW: Recursive inlining now allowed when using new shortcode styling. Protection against infinite loop coded.
5. NEW Added the showcontent attribute to control display of the post’s content.

Shortcode convention

Users will mainly notice that the code used to inline a post has been updated to the shortcode convention.

[ggisinlinepost id="%id" attribute1="%attr1" attribute2="%attr2"]

The previous code convention while deprecated will still work: [-ggis-inlinepost id=”%id” titletag=”%tag”-].

Usage is covered on the ggis-inlinepost page.

1. FIX: Correct paragraph/newline formatting.
2. NEW: Inlined post now recognizes the ‘more’ shortcode.
3. NEW: If a post requires a password, the password entry form will be displayed.
4. UPDATE: Improved display of metadata.

The metadata uses the following CSS classes for display:

• entry-meta
• meta-sep
• meta-prep

Please post your questions or comments on this post here.

QuickDown basically creates a link to the Remository page along with a variety of document information formatted within a table. Instead, I am usually interested in having a direct download link inserted inline with the article’s content.

There are 2 files that need to be modified in order to get this working properly. One of them is the Remository core file p-classes/remositoryRepository.php. The other is the plugin file quickdown.php.

Remository core change

The function makeCheck() is the one needing changes in remositoryRepository.php. Below are the original function and the updated function.

// ORIGINAL
function makeCheck ($id, $func) {
  $interface =& remositoryInterface::getInstance();
  return md5($this->Time_Stamp.$interface->getCfg('absolute_path').date('md').$id.$func);
}

// MODIFIED
function makeCheck ($id, $func) {
  $interface =& remositoryInterface::getInstance();
  return md5($interface->getCfg('absolute_path').date('md').$id.$func);
}

Notice that the only change is the removal of a UNIX timestamp. makeCheck() is used in the creation of the direct download link creation and in its verification before allowing download. This is a bit different than the approach I would take but it is effective. If you wanted to make a permanent direct download link, you would remove all references to date or time in the obfuscated check code.

The download link created by the above modified code is good until the next day begins. Is this too long? For your situation perhaps but not for mine. Regardless, please note that the download link duration should outlive your cache.

QuickDown plugin change

Next, I wish to change the formatted output of the plugin and to have it include a proper direct download link. I have taken some shortcuts in order to make my changes to the original files easier to follow and not insert bunches of my code into the original code. All of these modifications are done to the file quickdown.php.

First, I added the makeCheck function.

function makeCheck ($id, $func) {
  $absolute_path = '/my/absolute/path/remdocs';
  return ( $absolute_path . date('md') . $id . $func );
}

Instead of creating a Remository instance, I simply added my absolute path to the remository documents (quick and dirty).

Next, I added a new plugin usage code {inlinedown:ID}. This completely separates my approach from the author’s and allows usage of the plugin as originally intended.

In the botQuickdown() function at line 57, I added:

$row->text = preg_replace('/{inlinedown:.+?}/', '', $row->text);

Then at line 86, I added:

if (preg_match_all('/{inlinedown:.+?}/', $content, $matches, PREG_PATTERN_ORDER)) {
  //Get IDS
  foreach ($matches as $fmatch) {
    foreach ($fmatch as $match) {
      $match = str_replace("{inlinedown:", "", $match);
      $match = str_replace("}", "", $match);
      $output = $this->ggis_createLink($match, $this->params);
      $content = preg_replace("/{inlinedown:$match}/", $output, $content);
    }
  }
  unset($matches);
}

Finally, I added my own create link function named ggis_createLink().

function ggis_createLink($idparam, &$param){
  $inline = TRUE;
  //Getting File-info from Database
  $database =& JFactory::getDBO();
  $id = intval($idparam);
  $database->setQuery("SELECT * FROM #__downloads_files WHERE id=$id");
  $filelist = $database->loadObjectList();
  if ($filelist) {
    $file = $filelist[0];
    $url = 'index.php?option=com_remository&';
    $func = 'download';
    $url .= 'func='.$func;
    $url .= '&id='.$idparam;
    $url .= '&chk=' . $this->makeCheck($idparam,$func) . '&no_html=1';

    if ($inline){
      $output = '<a href="'. $url .'">';
      $output .= '<img src="components/com_remository/images/download_trans.gif" border="0" align="middle">';
      $output .= '<b>'. $file->filetitle .'</b> (' . $file->filetype . ' ' . $file->filesize . ')</a>';
    }else{
      $output = '<table>';
      $output .= '<tr><td><a href="'. $url .'">';
      $output .= '<img src="components/com_remository/images/download_trans.gif"border="0">&nbsp;';
      $output .= '<b>'. _DOWNLOAD .'&nbsp;'. $file->filetitle .'</b></a></td></tr>';
      $output .= '</table>';
    }
  }
  return ($output);
}

Final result

The final result is an inline direct download link. This link shows the download image, the file title, the file type, and the file size. Depending on your styling, it should look similar to the image below.

Hopefully, you may find this modification of Remository and QuickDown useful for your purposes.

To gain further understanding of which template files are used when view a WordPress site visit WordPress Site Architecture.

Narrow Column

The default single.php has its content div set to widecolumn. This needs to be changed to narrowcolumn.

<div id="content" class="widecolumn">
to
<div id="content" class="narrowcolumn">

Display Sidebar

Now display the sidebar by adding the following code just before the get_footer call.

FROM
<?php get_footer(); ?>

TO
<?php get_sidebar(); ?>
<?php get_footer(); ?>

Wow, it doesn’t get much easier than that! Now you know how to convert from without sidebar to with sidebar displays.

Reference links:

• WordPress Site Architecture

Create home.php

Simply copy your index.php to home.php. Most of the template will be the same except for a few minor modifications.

Sticky Posts

Sticky posts are those that will remain at the top of your home page regardless of their age. Create a hidden category named ‘_sticky’ and make note of it’s ID. Edit your home.php. Shortly after the <div id="content"> tag enter code similar to the following:

<?php query_posts('cat=86&showposts=2');?>
<?php if (have_posts()) : ?>
  <?php while (have_posts()) : the_post(); ?>
	<div class='post' id='post-<?php the_ID(); ?>'>
	<h2 class='articleHeadline'>
	<?php the_title(); ?>
	</h2>
	<p class='article'>
	<?php the_content('Read the rest of this entry'); ?>
	</p>
	</div>
  <?php endwhile; ?>
<?php endif; ?>

Firstly, make certain you replace 86 with the ID of your _sticky category. Now, some explanation of what is happening. The block which starts at <?php if (have_posts()) : ?> and ends at <?php endif; ?> is the standard WordPress Loop. So the trick here lies within <?php query_posts('cat=86&showposts=2');?>. This function call requests the most recent 2 (showpost=2) posts in the category with an ID of 86 (cat=86).

Display Regular Posts

Now in order for regular posts to display, we must reset our posts query. Let’s do a little more than that by also excluding all categories we wish to remain hidden. Just before the next Loop, add the following:

<?php query_posts('cat=-1,-86&showposts=10');?>

Here we are excluding categories with the IDs of 1 and 86 and then displaying the most recent 10 posts.

This article introduced two key concepts, the function query_posts and the Loop. Do a little digging into these concepts and you have gained large amounts of control over your site’s display.

Reference links:

• The Loop
• query_posts