Only fill this in if you're a spammer huh? Your name :
Your email :
Your message :

Tags: blogrum

Jun
9th
2008

AM Deluxe Profiles

Posted in : Plugins & Widgets

Extend your users profiles

This plugin adds a shiny new tab to your users profiles tab in admin and allows your users to have such delights as avatars, signatures, location. It also adds the ability for each user to enter their time offset from the server and set the date and time formats that they prefer to use, although that bit means you need to do a tad of skin work ;) These extra profile fields, and settings, can then be used to enhance your current skin and there's also the ability to display each/any users profile instead of that ugly "edit profile" page that you get in the stock evo skins. There's a setting to allow you to restrict the viewing of profiles to logged in members so that the spamming arses don't get access to any details like aim/msn/etc

Admin settings

Allow Avatars
This one's pretty self explanatory, untick it and the ability to use avatars is removed
Guest Avatar
This needs to be the full url to an image to use for guests ( note : this one is not auto-resized, so make sure you upload an appropriate sized image ;) ). Leave this blank to disable guest avatars
Guests
This setting allows you to control if guests can view members profiles, it defaults to "no". Note : this only works if you have an appropriate _profile.disp.php, a sample one is included in teh download. If you don't have an appropriate one then the normal evo action of showing the "edit profile" is shown, which bars guests anyway ;)
Allow Signature
This is another self-explanatory one, untick it and signatures are disabled ;) Note : Signatures will be stripped of any html
Renderers
This is a list of plugin codes that you want to be used to render the signatures, one per line. The default is to use the smilies, bbcode, code highlighter and auto-p plugins, but you can add any that you like. Note : The bbcode plugin will use the post replacements not the comments, this is to enable you to allow urls and images and stuff without getting bitch slapped in your comments by spammers ;)
Timezone
This is the default offset ( in minutes ) from the servers current time, which is handily displayed in the notes field
Time format
This is the default time format to use, meander over top php.net for the various settings you can use
Date format
Uncannily this is the default date format to use, and once again you should hit the php.net link for available settings

New Profile settings and how to use them in your skin

There's actually a couple of ways that you can call up the new settings in your skin. The individual methods are listed below. I'll ( try and ) explain the second method after them all ;)

Avatar
If enabled this will allow the users to select an avatar. They need to upload a file called avatar.jpg or avatar.gif or avatar.png or all 3 if they like to their user directory. The avatar will automatically be resized to 80px x 80px or summat. The user can choose any of the three images to use
Skin call ( default parameters shown ):

PHP:

<?php
$Plugins->trigger_event'UserAvatar'array(
        'display' => true// echo the results
        'block_start' => '<div class="userAvatar">'// html used before the <img> tag
        'block_end' => '</div>'// html used after the <img> tag
    );
?>
Signature
If enabled this allows users to slap in the signature of their choice. This will be rendered with the plugins that you slapped in the admin setting after any html has been stripped
Skin call ( default parameters shown ):

PHP:

<?php
$Plugins->trigger_event'UserSignature'array(
        'display' => true// echo the results
        'block_start' => '<div class="userSignature">'// html used before the signature
        'block_end' => '</div>'// html used after the signature
    );
?>
Location
This allows users to type in a witty location like at my bloody keyboard huh?. This is text only, any html will be stripped
Skin call ( default parameters shown ):

PHP:

<?php
$Plugins->trigger_event'UserSignature'array(
        'display' => true// echo the results
        'block_start' => '<div class="userLocation">'// html used before the location
        'block_end' => '</div>'// html used after the location
    );
?>
Timezone, Time format, Date format
This is exactly the same as the admin version and allows the user to see all dates and times in the format of their choice and in their local time. This one is a tad more complicated in your skin
Skin call ( default parameters shown ):

PHP:

<?php
$Plugins->trigger_event'UserSignature'array(
        'block_start' => '<p class="userDateTime">',
        'block_end' => '</p>',
        'display' => true,
        'output_format' => '$date$ @ $time$'// $date$ && $time$ will be replaced with users preferred format for date and time
    );
?>
You also need to pass the date-time that you wish to convert.

PHP:

// for $Item use :
        'localdatetime' => $Item->get'datecreated' );
// for comments use
        'localdatetime' => $Comment->get'date' );

An alternative method

An alternative method is to use the skintag call and pass it multiple parameters at the same time. It looks a tad more complicated but it really isn't that bad ;) Rather than repeat what's in the plugin code I'll just copy + paste it here and then try and explain it :p

PHP:

/**
     * This is gonna be a doozy to write :p
     * Displays all the various bits and bobs from the users profile
     * Triggers event AMProfileSkinTag() to allow other plugins to hook in ;)
     *
     * @param array $params
     *     avatar         - html output $avatar$ replaced with <img> tag for users avatar
     *     joined         - html output $date$ && $time$ replaced with date/time user registered, display in current users preferred format and time offset
     *     location     - html output $location$ replaced with users location
     *     name             - html output $name$ replaced with users name ( replaces 'profile' if no linked profile )
     *     posts         - html output $posts$ replaced with total posts and comments by user
     *     profile     - html output $profile$ replaced with profile link
     *     signature - html output $signature$ replaced by users signature
     *     website     - html output $website$ replaced by website url, $name$ replaced with users preferred name
     *     no_guests - html output displayed when telling guests to piss off
     *     profile_display - boolean are we displaying the profile
     *     ouput_format - html output
     *         replacement vars
     *             $avatar$ - replaced with avatar html if set
     *             $joined$ - replaced with joined html if set
     *             $location$ - replaced with location html if set
     *             $posts$ - replaced with posts html if set
     *             $profile$ - replaced with profile html if set
     *             $signature$ - replaced with signature html if set
     *             $website$ - replaced with website html if set
     *
     */
    function SkinTag$params )
    {
        $params array_mergearray(
                'signature' => '<p class="userSignature">$signature$</p>',
                'profile' => '<p class="userProfile">$profile$</p>',
                'name' => '<p class="userName">$name$</p>',
                'avatar' => '<p class="userAvatar">$avatar$</p>',
                'datetime' => '<p class="userDateTime">$date$ @ $time$</p>',
                'location' => '<p class="userLocation">$location$</p>',
                'joined' => '<p class="userJoined">$date$</p>',
                'posts' => '<p class="userPosts">$posts$</p>',
                'website' => '<p class="userWebsite"><a href="$website$" title=" '.sprintf$this->T_'visit %s\'s website' ), '$name$' ).' ">'.get_icon'www''imgtag' ).'</a></p>',
                'no_guests' => $this->T_'You need to be a registered member to view profiles' ),
                'profile_display' => false,
                'output_format' => '',
            ), $params );

Looks simple huh ? :roll: The main value is the output format, this is where you get to choose what's spat out and in which order. Continuing in my copy + paste fashion this is how it's called for the comments on my blog :

PHP:

<?php
$Plugins->call_by_code'am_profiles'array(
        'obj' => $Comment// change this to $Item for posts or $current_User for profiles
        'profile' => '<span class="profileLink">$profile$</span>',
        'name' => '<span class="userName">$name$</span>',
        'avatar' => '$avatar$',
        'posts' => '<p class="postCount">Posts : $posts$</p>',
        'joined' => '<p class="userJoined">Joined : $date$</p>',
        'location' => '<div class="userLocation">Location : $location$</div>',
        'output_format' => '$profile$'."\n"
                    .'$avatar$'."\n"
                    .'$posts$'."\n"
                    .'$joined$'."\n"
                    .'$location$'."\n"
    ) );
    ?>

and finally, displaying profiles

Displaying profiles is pretty similar to the code I pasted above. The main difference is that you want all fields and you pass on an extra parameter to tell the plugin that it's displaying the profile as opposed to just showing the users fancy new settings. When you do that the plugin will automatically trigger any other plugins that have the right hooks ;) Rather than re-pasting the sample profile pages code ( which is included in the zip ), you can see it here ( Sample _profile.disp.php ). You can just drop that page into your skins folder and it'll work

Did I mention hooks for other plugins?

To enable other plugin developers to add their own profiles stuff this plugin adds a few new hooks. To use them you need to inform the core that you can react to them with the following :

PHP:

function GetExtraEvents()
    {
        return array(
            'AMProfileTabAction' => 'AdminTabAction() when on our profile tab',
            'AMProfileTabPayload' => 'AdminTabPayload() when on our profile tab',
            'AMProfileSkinTag' => 'Triggered when our SkinTag() is called',
             );
    }

The events should be pretty self explanatory and are passed the following parameters :

PHP:

$Plugins->trigger_event'AMProfileTabAction'array(
                    'AMProfileUrl' => $this->url,
                    'user_ID' => $user,
            ) );

PHP:

$Plugins->trigger_event'AMProfileTabPayload'array(
                            'AMProfileUrl' => $this->url,
                            'Form' => & $Form,
                            'user_ID' => $user,
                ) );

PHP:

$Plugins->trigger_event'AMProfileSkinTag'array(
                    'AMProfileUrl' => $this->url,
                    'output_format' => $params['output_format'],
                    'user_ID' => $user,
        ) );

So, now that you've read all that, go download the plugin ( am_profiles.zip ) and enjoy your shiny new tab ;)

¥

2848 views and only 19 comments
Top ways you found my blog
Jun
2nd
2008

Opening the blogrums

Posted in : Techno Babble

It's like a forum, but it's a blog

Finally, I've mostly integrated the old blogrum code with InnerVisions .... I've even started a tutorial on how to add a blogrum to your own b2evolution blog .... don't get excited though, it's nowhere near finished and I'm not in any great rush ;). There's still a fair amount of work to do with it before it's anywhere near the end result I have in mind, and the skins a tad shagged in IE6, but I'll be re-skinning it as soon as I've got all the code working and testing, so either put up with it or switch to a browser that it does work in ;)

I've decided that I can't be arsed importing all the current blogrums posts/comments/users, it's more hassle than it's worth so I'll just leave the current version where it is and shut down the ability to post/comment there. I also haven't redone the ability to create a new post from the frontend, I'll work on that when I get more free time. For the moment it's only linked in my drop down menus as I'd need to redo the header graphic to add it to the menu buttons, and I'm liable to go for a whole new skin if I have to go to that effort anyway ;)

Anyway, feel free to have a play, and let me know if you find any bugs/quirks ;)

¥

2184 views and only one comment
Mar
20th
2008

Playing with a blogrum

Posted in : Techno Babble, Skins, Hacks, Plugins & Widgets

Convincing Evo that it's a forum

On the grounds that it's often easier to show something than try explaining it .....go visit the blogrum. Before you ask, no it's not ready for release yet, I need to sort out some permissions stuff to do with comments and tidy up the code and css ..... cos it's a tad messy in there ..... and then it's gonna take a mammoth post to explain what it can do, how, where, why and when. The good news is that it's pretty much just a trick skin with a couple of plugins thrown in, although I have a few more plugins in the works to make it work even more like a forum.

Registration is open, so if you want to have a play then feel free, although guest users can comment in the chatter blogrum so if all you want to do is spam me then there's no need to even register ;)

¥

Tags: blogrum
4302 views and only 2 comments
 
 
 

X