EE Insider Tips

Search EE Docs in Chrome URL Bar with an alias

2011-07-03T16:04:03+00:00

I search the EE Docs, EE Forums and CI Docs all the time. I created a short alias in the Chrome for each site to save time. Chrome allows you to create custom search engine options. You can see how here.

http://www.google.com/support/chrome/bin/answer.py?answer=95653

Use this code for your custom search: http://www.google.com/search?q=%s&as_sitesearch=expressionengine.com%2Fuser_guide%2F&x=0&y=0

Now when you type the short alias (EE in my case) then space, add your query and it will search the EE Docs. Great way to save time while searching EE Docs, EE Forums, or whatever custom EE query you want to build.

Add rel=“nofollow” to all auto generated links in a weblog entry

2011-02-17T19:27:29+00:00

File: core.typography.php, for version 1.6.x

This will add rel=“nofollow” to all of your auto generated links in weblog entries.

Line 902:

change:

$str = str_replace($matches['0'][$i], '.$bounce.trim($url).'"'.$extra.'>'.$matches['2'][$i]."", $str); 

to:

$str = str_replace($matches['0'][$i], '.$bounce.trim($url).'"'.$extra.' rel="nofollow">'.$matches['2'][$i]."", $str); 

Disallowed Key Characters

2011-01-20T11:55:02+00:00

I’ve had this twice now on my Freeforms so thought it may help someone else.

One of my form element names had a leading space which caused this error.

How I found it was to add a little debugging to the core.

In the file: core.input.php (EE v1.7.0) there is a method called: clean_input_keys on approx line 444. The method exits if the preg_match fails with ‘Disallowed Key Characters’. I changed the exit to give us a little info from:

exit(‘Disallowed Key Characters.’);
to
exit(“Disallowed Key Characters: $str”);

A generic User Message Template

2010-12-09T18:06:36+00:00

Here’s a simple, generic User Message Template that’s gentler on the eyes than the EE default. Easy to customize as well to match your site’s colours if you’re so inclined!

DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    {meta_refresh}
    <style type="text/css">
        body { background: #F3F3F3; color: #666; font: normal 14px/19px Arial, Helvetica, sans; padding: 50px; text-align: center; }
        #content { background: #FFF; -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; -moz-box-shadow: 0px 0px 10px #CCC; -webkit-box-shadow: 0px 0px 10px #CCC; box-shadow: 0px 0px 10px #CCC; margin: 0 auto; padding: 25px 50px; text-align: left; width: 700px; }
        h1 { color: #000; font-size: 32px; line-height: 36px; }
        a { color: #000; }
        a:hover { text-decoration: none; }
    style>
head>
<body>
    <div id="content">
        <h1>{heading}h1>
        {content}
        {link}
    div>
body>
html> 

Here’s an example: http://i51.tinypic.com/154j4hs.png

Javascript Pagination with Matrix / MX Calc and jQuery

2010-09-27T19:23:09+00:00

I ran into a situation where I couldn’t use generic slider-scripts due to their fixed width/height nature and absolute positioning, so I had to concoct my own. You’ll need Matrix (obviously) and MX Calc.

The template-tags:

{contentblocks}
    <div class="block{if row_count == '1'} active{/if}" id="block_{row_count}">
        {content_text}
        {if total_rows != '1'}
            <p class="nextprev">
            {if row_count != '1'}
                <a href="#block_{exp:mx_calc expression='{row_count}-1'}" class="navigation"><img src="/images/prev.png" alt="Vorige" />a>
            {/if}
            {row_count} / {total_rows}
            {if row_count != total_rows}
                <a href="#block_{exp:mx_calc expression='{row_count}+1'}" class="navigation"><img src="/images/next.png" alt="Volgende" />a>
            {/if}
            p>
        {/if}
    div>
{/contentblocks} 

the jQuery

$("a.navigation").click(function(event){ // Trigger click
        
            $(this).parents('.block').removeClass('active'); // Hide current block
            
            $(this.hash).addClass('active'); // Get next/previous block from link and show it
        
        });

disappearing entries that suddenly reappear! DST!

2010-07-06T12:39:00+00:00

OK, this drove me mad over the last two days.

Ever had entries which you update on your site disappear after your update them? (and reappear later)

I thought something was caching - so turn caching off and cleared current cache. No joy.

The culprit was Daylight Saving Time setting on EE.

My entry date was one hour ahead of my server time so did not publish for an hour.

So - how do you absolutley set DST consistently?

1: Turn off daylight time saving in CP
2: Turn off daylight time saving for all users who might be adding content
3: Don’t let users edit their own daylight saving
4: Ensure “Honor the Daylight Saving Time setting associated with each channel entry?” is set to No.
5: Adjust and re-save any previously saved entries

A nod in the general direction of dp_miller from the EE forums for this, thought it was a big enough ‘gotcha’ to warrant a post here.

http://expressionengine.com/forums/viewthread/156835/

Add a {last_segment} global variable

2010-06-28T12:41:53+00:00

IMPORTANT UPDATE:
EllisLab has added an official {last_segment} tag as of EE 2.1.1. See info here: http://expressionengine.com/blog/entry/2.1.1_release_what_will_be_there_what_will_not/

—-

Sometimes it is quite handy to pull in the last segment of a URI. EE makes it easy to grab the first segment by using {segment_1} but there is no {last_segment}. With a little help from PHP and path.php we can change that. Add this to your path.php file at the global_vars array*.

// Get the last segment of the URL and make it a global var
$page_uri = $_SERVER['REQUEST_URI'];
// First we strip the last character of the URL if it is a trailing slash
if(substr($page_uri, -1, 1) == '/')
{
   $page_uri = rtrim($page_uri, '/');
}
// now we explode the URI into array segments, then reverse them
$segments = array_reverse(explode('/', $page_uri));
// that makes our new "first" segment our actual last segment (which we make a global var below)
$last_segment = $segments[0];

// Global variables for our site
$global_vars = array(
   "last_segment" => $last_segment
   );
?> 

Now you can use {last_segment} across your site as needed.

* Note that you may need to merge this $global_vars array with your current $global_vars if you’ve already added your own.

Config Overrides for EE 1 and 2

2010-06-17T12:07:08+00:00

I don’t think I’ve seen this one before, but the EE Wiki contains a full list of config.php overrides, which are easily found by doing the following in a EE 1.6.x template with PHP enabled:

    global $PREFS;
    print_r($PREFS);
?> 

The list in the wiki is only for 1.6.7, so some may have changed or been added.

To get this to work in EE 2 you need to do it a little differently (again in a EE template with PHP enabled). EE 2 does away with the global $PREFS, so you need to print out the available config settings:

    print_r($this->EE->config->config);
?> 

This will output a long list of config settings that you should be able to use in your config.php file to override values stored in the database. Here’s the list I came up with when checking against the beta.

The filetype you are attempting to upload has invalid content for its MIME type

2010-04-28T12:33:07+00:00

Well this one is different to the Freeform upload issue I added a week or so ago.

When a user uploads content EE attempts to filter that content against XSS - (Cross Site Scripting, a technique the bad guys use to compromise your site)

A logged in Super Admin automatically is trusted by EE and bypasses XSS filtering but your users get filtered. This lead to a situation where I could upload (as Super Admin) but other site members could not without seeing the error, ‘The filetype you are attempting to upload has invalid content for its MIME type’.

You can turn XSS filtering off completely…but that’s bad! you shouldn’t do that. The solutions is a Hidden Configuration Variable!

Get the ID’s of your trusted member groups you want to bypass XSS filtering and note them down.

Then open your config.php file and add the following:

$conf[‘xss_clean_member_group_exception’] = “7,6”;

The above is a comma separated list of XSS member group exceptions, just add your trusted groups (in my case 7,6) and away you go.

jfp.

Add a dynamic page_uri global variable

2010-04-14T14:50:35+00:00

For some strange and odd reason, there is no full page_uri global variable built in to EE (that I’ve found at least). You can access each segment with segment variables but there’s not a way to get everything after your domain. We can easily add one by opening our path.php file and adding a global variable there. If you haven’t already created any global variables in your path.php file then it probably has this


$global_vars = array(); // This array must be associative

We can add a variable like this:

$global_vars = array('current_uri'=>$_SERVER['REQUEST_URI']); // This array must be associative 

This enables us the use of {current_uri} in our templates. On this page, for example, it would return /tips/add-a-dynamic-page-uri-global-variable/.

One Note: This is using PHP, not EE so it will include anything after the domain. That means “index.php” would be part of it if you aren’t removing it from the URI in some fashion.

Dynamically display Year from entries not from this year

2010-04-14T14:06:44+00:00

I personally hate going to blog sites and not knowing when an article was published. I often see “June 2” but no year. Sometimes I’m actually interested in whether or not that means this June 2nd or last June second, or even an June from years ago.

Here is a simple way to automagically display the year once the entry is from “last year”. It’s just a simple conditional check against the date.

{entry_date format="%D %M %d"}{if {current_time format='%y'} != {entry_date format='%y'}}{entry_date format=', %Y'}{/if} 

The filetype you are attempting to upload is not allowed

2010-04-09T04:52:47+00:00

Having a problem uploading an certain filetype and seeing this error message?

I had this today with a Freeform file upload field when trying to upload a .tif file.

Solution:
edit your mimes.php file.

Find it in /system/lib/mimes.php and edit the $mimes array.

My $mimes array now finishes like this.

...snip

‘aac’ => ‘audio/aac’,
‘tiff’ => ‘image/tiff’,
‘tif’ => ‘image/tiff’
);

Note: if you cannot figure what to do once you view the file then you really shouldn’t be doing it.

Gotcha: remember to hide your memberlist

2010-04-05T07:47:46+00:00

Once you have set up your site you may find that your memberslist with screen_name is visible to all. To test this visit:
http://www.YOURDOMAIN.com/member/memberlist

Horrible isn’t it.

Anyway, to turn this off you have to do it per member group, in the back end go to:
CP Home› Admin› Members and Groups› Member Groups› Edit Member Group› Guests (or other member group)

Now click on “Member Account Privileges” and set “Can view public profiles” to “No”

Do this for all member groups you don’t want to see that page.

Another way is to change the trigger word:
CP Home› Admin› Members and Groups› Membership Preferences
then change the “Profile Triggering Word” to something random. The first method is best as this way only obfuscates the memberlist.

Personally I think this should be set to ‘No’ in a default install, but it’s not.

Quote your variable when using within an if condition

2010-03-09T10:24:22+00:00

This has just caught me out…

Basically if your using a variable within an if condition ensure you quote it.

{assign_variable:my_entry_id="{segment_3}"}
{assign_variable:sendit="{segment_4}"}

{if "{sendit }" == "true"} {!-- <= if {sendit} is not quoted it the logic fails --}

  This is true
{if:else}

  This is not
{/if} 

Better handling of comment list and comment form display

2010-02-13T12:29:04+00:00

First, I suggest making your comment form and comment list markup into distinct templates, which accept a single embedded variable (“weblog”). This allows you to reuse these templates wherever you allow comments on your site. Say these are located at embeds/comment_list and embeds/comment_form.

Then, use this code at the end of your entries, where you want comments to display:

{if comment_total > "0" || allow_comments}
    {embed="embeds/comment_list" weblog="blog"}
{/if}

{if allow_comments}
    {embed="embeds/comment_form" weblog="blog"}
{if:else}
    <p class="no-comments">Comments are now closed.p>
{/if} 

This technique circumvents the generic “Commenting is not available in this weblog entry” message that appears when comments are closed. Note that this must be placed within your weblog:entries loop.

Using EE’s XID in Ajax

2010-02-02T09:28:01+00:00

If you’re submitting data in the EE CP through Ajax you may run into some issues where you’re constantly 302 redirected back to the homepage. One reason for this is you’re not submitting an XID hash to ensure the security of your form.

To fix this simply add the following somewhere in the data to-be-submitted:

{...'XID': 'add_form_security_hash('{ XID_HASH }')?>'...}

[Note: Remove the spaces from around XID_HASH, keeping them in was breaking the display.]

That should ensure you get past the XID check.

Using view files in custom extensions

2009-11-11T08:10:02+00:00

With EE 1.6.8, we now have the ability to use view files in modules and that’s great news for add-on developers. Recently I wanted to use view files for an extension I was developing, but the EE docs do not list a way to do that. Specifically, I wanted to use view files for the extension settings form and for the contents of the publish tab for the extension. Here’s a snippet of how to use view files in a custom extension:

$DSP->body .= $DSP->view(PATH_EXT.'ext_widget/ext_settings.php', $vars, TRUE); 

I created a folder called ext_widget to hold my view files, keeping the view file separated from other extension files.

Make embedded params tag params.

2009-11-08T19:40:55+00:00

You can access embed params directly in your plugin code. This is super useful when you include a plugin / module inside an embedded template and need to pass through params.

 
// http://gist.github.com/204612

make_embed_params_tag_params()
{
    // the valid params for the tag
    $valid_params = array(
        'entry_id',
        'weblog_id',
        'url_title'
   );
 
    // for each of the embedded params
    foreach ($TMPL->embed_vars as $key => $value)
    {
        // parse the param key
        // embed: ... 
        $param_key = substr($key, 6);
        if(
            // is the tag param actually set?
            isset($TMPL->tagparams[$param_key]) === FALSE
            // is the embbed param in the valid params array?
            && in_array($param_key, $valid_params)
        )
        {
            // add the embed param to the tag param
            $TMPL->tagparams[$real_key] = $value;
        }
    }
} 

Cover Image with FF matrix gallery

2009-11-07T20:43:44+00:00

Making a gallery using FF Matrix and Ngen file field is a very popular way to make a gallery. I made a gallery like this but wanted to pull one image from each gallery into the sidebar and also using the same image as a post image in a news item.

Now the client can change the cover photo easily without having to reorder the matrix.

To ensure that the image pulled was the same one and chosen by the client I added a checkbox to the matrix. and then used the following code.

Sidebar Gallery

{exp:weblog:entries weblog="gallery" dynamic="off" limit="9 orderby="random" disable="trackback|member_data|comments"}
        {gallery}
            {if cover}
                {exp:imgsizer:size src="{photo}" width="73" height="73"}
                    {title_permalink=photos/gallery"}"><img src="{sized}" width="{width}" height="{height}" alt="{caption}" />a>
                {/exp:imgsizer:size}
            {/if}
        {/gallery} 
    {/exp:weblog:entries} 

and using related entry on the news page

{related_entries id="gallery_relationship"}
    {gallery}
        {if cover}
            {exp:imgsizer:size src="{photo}" width="550" height="300"}
                <img src="{sized}" width="{width}" height="{height}" alt="{caption}" class="newsBgThumb" />
            {/exp:imgsizer:size}
        {/if}
    {/gallery}  
{/related_entries} 

Managing comments

2009-10-30T09:12:31+00:00

Just learned this from a client(!). To view a list of all comments on your site, from the Edit screen, leave the keywords field blank, choose “Comments” from the “Search In” dropdown, and search. You can also use the Weblog filter to view comments from one specific weblog.

(This is actually in the docs, but who reads those anyway?)

You can then add a “Manage Comments” tab by adding the following URL in the Tab Manager.

http://yoursite.com/system/index.php?C=edit&M=view_entries&search_in=comments