The Arcive of Official vBulletin Modifications Site.

[ITECH] Inferno External Lite · **Released**: 01-02-2008

----------------------------------
[ITech] Inferno External Lite
Created By Inferno Technologies (http://www.infernotechnologies.net)
Copyright 2004-2007
All rights reserved
Project Development Team: Zero Tolerance
Project Lead: Iain "Decado" Kidd
----------------------------------

Project Description

This product is designed to take data from your forum, and easily export it in a HTML format onto any type of website you have (note, the website must be on the same server as the forum). For instructions and features, read on.

Note
we can't provide screenshots of this in use as it would be completely unique to your website, but we have included the acp stuff

Features

Data Feeding
-----------------------
Inferno External's main purpose is to provide you with the power to easily display data from your forum, to your website, without any knowledge of programming!

Module Blocks
-----------------------
Creating a data feed has never been as easy, you can simply create a block by choosing what type of data you want to extract, customise it with options, and save, all through an Admin CP interface.

Previewing / Templates
-----------------------
As with most development processes, before taking anything live on a website you want to preview how it will look. Inferno External gives you a snapshot of how the block will look exactly on your website, with exception to your websites style/css.Customising blocks is no problem at all, either if it's a setting, or how it's displayed. Inferno External employs ITS ("Independant Template System") that allows you modify templates for a block without effecting any other block!

Module: No. Users Online
-----------------------
This compact version of users online simply displays the numbers of members, guests and hidden users online. You can configure this to only show members/guests or just hidden if you wish, and again hide certain usergroups!

Module: Threads
-----------------------
This module block can give you a listing of threads from x, y and z forums, kinda like creating your own forum display page! It has all kinds of configuration to handle data exactly how you want: * Max Threads To Display
* Maintain Permissions (So users only see threads they're supposed to!)
* Forums To Scrape (Which forums to fetch threads from)
* Filter Results (Enter custom search terms to customise which threads are shown!)
* Ordering (How you want the threads to be ordered, such as date, poster name, thread title)
* Display Threads From (Ranging from Today to This Month to This Year and more!)
* Titles/Username Cutting (So a long thread title doesn't bombard your style)

Module: Thread Posts
-----------------------
This is similar to the threads module, only instead of displaying a similar forum display look, it displays the first post of the threads! This could be used simply to show latest threads, custom blogs, or news! Also has extended configuration to meet your demands: * Max Posts To Display
* Maintain Permissions (So users only see posts they're supposed to!)
* Forums To Scrape (Which forums to fetch posts from)
* Filter Results (Enter custom search terms to customise which posts are shown!)
* Parse BBCode (The system cleverly makes sure images such as smilies and links work!)
* Ordering (How you want the posts to be ordered, such as date, poster name, thread title)
* Display Posts From (Ranging from Today to This Month to This Year and more!)
* Titles/Username/Post Cutting (So a long post doesn't bombard your style)

Tutorial On Usage

Quote:

Inferno External as you know, provides you with the power to export certain data in a visual format to any part of your website. Ideally this is developed around the idea that you the user, wants to display data/information from your forum, onto your main website.

Where do you begin?
The first step is really to set up a new "block", the term block will refer to a set up you've configured in your ACP to export X data, in this example we're going to walk through how you'd set up an External Users Online. The users online has is a very simple interface, for users and guests.

To begin, go to your Admin CP, then 'Inferno External', and on this page you want to click 'Create New Block'. First you will see a drop down menu to choose what kind of block you want to create, select 'Users Online' here then hit 'Proceed'.

The next page takes you to the block configuration, now this block has a few custom options, you can decide what types of online data you wish to display (members, guests and hidden), additionally you can hide UGs from being counted here. There is also the default configuration which you get with all blocks:

Block ID
The block ID is an alphanumeric reference to the block you are creating, it can contain characters a-z, 0-9 and underscores (_). For this example, simply input 'my_users_online', which is a fairly useful ID to give this block.

Viewing Permissions
The viewing permissions is a global setting for all blocks, allowing you to create blocks that can be viewed by certain usergroups, or every usergroup. Don't touch this setting, for our example we want all usergroups to see our new block.

That's it for configuration, you'll find other blocks will have more settings depending on what they are, allowing you to customise them, remember aswell that you can create several blocks of the same type!

Hit 'Save Module Block' and this block will then be saved, and you'll be sent back to the main Inferno External admin page. Here, you should see your newly created block, and we can take a peak too, so click on 'Preview' for your newly created block.

The preview page will give you two things, one is the code you'd need to display this block on any page on your website, and secondly how the block will look. Note that how the block looks will differ, as it depends really on your websites style/css. In the preview here you'll be able to see the users online, all simple.

Hit 'Go Back' to return to the main admin page again, this time click 'Block Templates'. Inferno External employs an ITS ("Independant Template System"). This allows you to create a block, customise the templates for that block, and not have it affect any other block, even of the same types. So for example, if you have two user online blocks, and changed the templates on one of them, it would not effect the other!

If you want to in the future, you can come back to this page and change the templates as you see fit, if you ever make a mistake, simply leave the template blank and it will return to default.

Cool, I have my block, how can I put it on my website?
This is the main part of the system, putting blocks on your website. Firstly, you're website will need to be in php (don't panic!).

What if my site isn't PHP, but HTML?
Not to worry, let's say you have your main site file as 'index.htm' or 'index.html', simply rename the file to 'index.php' and your server will treat this file as php, and still parse your html!

Cool, it's php now, where do I begin?
You need to begin by 'loading' Inferno External into your website, to do this, open say index.php, or any other file on your website that's php and which you want to test (you could even create a test.php if you wish). At the very top of the file insert the following code:

Code:

<?php
require_once('./MYFORUM/infernoexternal.php');
?>

Please Note! You will need to alter this slightly, notice the 'MYFORUM' part, this needs changing to your forums directory, and assumes the file you're editing is one level above your forum directory. If that made little sense, not to worry!

Let's say your website is: mysite.com, and your forum is: mysite.com/forums/, and you're editing 'mysite.com/index.php', you'd use the following code:

Code:

<?php
require_once('./forums/infernoexternal.php');
?>

Another note, once this has been included in your PHP file once, you do not need to insert the code again, while it won't do any harm, it won't do anything either, this only needs to be at the top of your php files.

Okay, that's done, how do I display my cool new block?
You'll need to enter another peice of code to actually display the block, and that code is the one you saw when you previewed the block earlier in the acp, so run back there and copy that code. Now where-ever you want the block to display, place the code:

Code:

<?php echo $infernoexternal->display_block('my_users_online'); ?>

Two things to note here, one is the code I just showed has 'echo ', which the code in the preview doesn't, this command tells php to spit out whatever comes next to the page. If you know a bit about PHP, then you'll be able to tell this function returns the HTML rather than forcefully spitting out when called, so you can use it in other ways rather than just echo. Additionally there are the PHP tags, which are needed so the system parses this as PHP and not HTML/plain-text.

The second thing to note, is the 'my_users_online', and if you're asking yourself "I remember that from somewhere", then yes you do, it's the Block ID you gave to your block. So this is telling the system which block you want displaying.

Now that's done, save your file, upload, and you should see the block nicely sitting on your website where you told it to be, that easy!. You can now manage your block in your admin cp without having to come back to the code and modify it. I should point out that if you delete the block and you don't update the code on your website, your website will return an error message, so if you ever want rid of a block, it's better practice to update your files and strip the code which displays the block, before actually deleting it from the Inferno External admin cp.

Nice, my own block, that was easy!
Very much so!

If you have questions, issues, problems, or anything related, feel free to post and we'll take a look!

Enjoy everyone!

- Zero Tolerance

Warlord · #32 02-11-2008, 04:32 PM

The following modification was done for vBExternal Lite, I would've posted this in that thread, but it's locked and says to come to this one.
I'm running vBulletin 3.6.4

Okay, I tried to modify this so it would work with attachments but unfortunately I'm coming up short for some reason.

Here's what I did.

In vbExternal.php find:

PHP Code:


			
                                'threadid'     => $Thread['threadid'],

                                'threadname'   => $Thread['title'],

                                'postuserid'   => $Thread['postuserid'],

                                'postusername' => $Thread['postusername'],

                                'replies'      => vb_number_format($Thread['replycount']),

                                'views'        => vb_number_format($Thread['views']),

                                'lastposter'   => $Thread['lastposter'],

And REPLACE with this:

PHP Code:


			


                                'threadid'                      => $Thread['threadid'],

                                'threadname'                    => $Thread['title'],

                                'postuserid'                         => $Thread['postuserid'],

                                'postusername'                    => $Thread['postusername'],

                                'replies'                             => vb_number_format($Thread['replycount']),

                                'views'                            => vb_number_format($Thread['views']),

                                'lastposter'                        => $Thread['lastposter'],

                                'attachments'                    => $show['attachments'],

                                'cellpadding'                     => $stylevar[cellpadding],

                                'thumbnailattachment'               => $show['thumbnailattachment'],

                                'attachedthumbnails'                => $vbphrase[attached_thumbnails],

                                'formspacer'                         => $stylevar[formspacer],

                                'thumbnailattachment'                => $post[thumbnailattachments],

                                'imageattachment'                  => $show['imageattachment'],

                                'attachedimages'                 => $vbphrase[attached_images],

                                'imageattachments'                => $post[imageattachments],

                                'imageattachmentlink'             => $show['imageattachmentlink'],

                                'imageattachmentlinks'               => $post[imageattachmentlinks],

                                'otherattachment'                => $show['otherattachment'],

                                'attachedfiles'                    => $vbphrase[attached_files],

                                'otherattachments'                => $post[otherattachments],

                                'moderateattachment'            => $show['moderatedattachment'],

                                'attachmentspendingapproval'    => $vbphrase[attachments_pending_approval],

                                'moderatedattachments'             => $post[moderatedattachments],

Save and upload.

In NEWS.PHP (located in your root/vbExternal folder)

Find:

PHP Code:


			
{post}

And BELOW it ADD:

Code:




		<!-- attachments -->
		<if condition="{attachments}">
			<div style="padding:{cellpadding}px">
			
			<if condition="{thumbnailattachment}">
				<fieldset class="fieldset">
					<legend>{attachedthumbnails}</legend>
					<div style="padding:{formspacer}px">
					{thumbnailattachments}
					</div>
				</fieldset>
			</if>
		
			<if condition="{imageattachment}">
				<fieldset class="fieldset">
					<legend>{attachedimages}</legend>
					<div style="padding:{formspacer}px">
					{imageattachments}
					</div>
				</fieldset>
			</if>
			
			<if condition="{imageattachmentlink}">
				<fieldset class="fieldset">
					<legend>{attachedimages}</legend>
					<table cellpadding="0" cellspacing="{formspacer}" border="0">
					{imageattachmentlinks}
					</table>
					</fieldset>
			</if>
			
			<if condition="{otherattachment}">
				<fieldset class="fieldset">
					<legend>{attachedfiles}</legend>
					<table cellpadding="0" cellspacing="{formspacer}" border="0">
					{otherattachments}
					</table>
				</fieldset>
			</if>
			
			<if condition="{moderatedattachment}">
				<fieldset class="fieldset">
					<legend>{attachmentspendingapproval}</legend>
					<table cellpadding="0" cellspacing="{formspacer}" border="0">
					{moderatedattachments}
					</table>
				</fieldset>		
			</if>
			
			</div>
		</if>
		<!-- / attachments -->

Save and upload.

Now theoretically I think this should've worked, but like I said, I'm running into a few speedbumps.

1. It doesn't seem to recognize the IF statements for some reason
2. The actual attachments don't show. (you can tell it's trying, but I think maye my variables in vbExternal.php aren't defined correctly maybe?)

Any coder here want to tell me where I went wrong?

Attached is a screen shot of the results I've gotten so far.

Warlord · #33 02-11-2008, 06:08 PM

Ok, I realized I added the variable definitions in the wrong block of code. (I was putting them in the Newest Threads block instead of the News block).

It's still not working correctly, but I think I'm getting closer.

To undo the changes I made in the above post and correct them to what I have now, you're just moving some code around:

In vbExternal.php find:

PHP Code:


			


                                'attachments'                    => $show['attachments'],

                                'cellpadding'                     => $stylevar[cellpadding],

                                'thumbnailattachment'               => $show['thumbnailattachment'],

                                'attachedthumbnails'                => $vbphrase[attached_thumbnails],

                                'formspacer'                         => $stylevar[formspacer],

                                'thumbnailattachment'                => $post[thumbnailattachments],

                                'imageattachment'                  => $show['imageattachment'],

                                'attachedimages'                 => $vbphrase[attached_images],

                                'imageattachments'                => $post[imageattachments],

                                'imageattachmentlink'             => $show['imageattachmentlink'],

                                'imageattachmentlinks'               => $post[imageattachmentlinks],

                                'otherattachment'                => $show['otherattachment'],

                                'attachedfiles'                    => $vbphrase[attached_files],

                                'otherattachments'                => $post[otherattachments],

                                'moderateattachment'            => $show['moderatedattachment'],

                                'attachmentspendingapproval'    => $vbphrase[attachments_pending_approval],

                                'moderatedattachments'             => $post[moderatedattachments],

And DELETE it.

Then find:

PHP Code:


			


        while($News = $db->fetch_array($NewestNews)){

        $Data .= ParseTemplate($Template,

                            array(

                                'threadid'     => $News['threadid'],

                                'threadname'   => $News['title'],

                                'postuserid'   => $News['postuserid'],

                                'postusername' => $News['postusername'],

                                'post'         => $bbcode_parser->parse(unhtmlspecialchars($News['pagetext']), $f),

                                'comments'     => vb_number_format($News['replycount']),

And UNDERNEATH that ADD:

PHP Code:


			
                                'attachments'                    => $show['attachments'],

                                'cellpadding'                     => $stylevar[cellpadding],

                                'thumbnailattachment'               => $show['thumbnailattachment'],

                                'attachedthumbnails'                => $vbphrase[attached_thumbnails],

                                'formspacer'                         => $stylevar[formspacer],

                                'thumbnailattachment'                => $post[thumbnailattachments],

                                'imageattachment'                  => $show['imageattachment'],

                                'attachedimages'                 => $vbphrase[attached_images],

                                'imageattachments'                => $post[imageattachments],

                                'imageattachmentlink'             => $show['imageattachmentlink'],

                                'imageattachmentlinks'               => $post[imageattachmentlinks],

                                'otherattachment'                => $show['otherattachment'],

                                'attachedfiles'                    => $vbphrase[attached_files],

                                'otherattachments'                => $post[otherattachments],

                                'moderateattachment'            => $show['moderatedattachment'],

                                'attachmentspendingapproval'    => $vbphrase[attachments_pending_approval],

                                'moderatedattachments'             => $post[moderatedattachments],

This gets rid of some of the extras that were beingt output on the page to make it look like this. I'm still having problems though as you can see from the attached thumbnail. I'm kind of lost at this point I think, so any help anyone would like to offer would be much appreciated. Thanks.

Fraik · #34 02-14-2008, 01:33 PM

Quote:

Originally Posted by Fraik

I'm having an issue... trying to create a news block but when I type in the number of posts to display and save it resets again, so its displaying all the posts!

Edit: When just displaying threads the number limit works just fine, it just doesn't work for thread posts

Any help, please?

Kalochero · #35 02-20-2008, 07:53 AM

Same Problem here.

cddw.ltd · #36 02-26-2008, 05:54 PM

Anyone know where to add the "require_once" code in Joomla?

If I put it in index.php (root) it logs me out.
If I put it into the template header it makes the page blank!?

azn_romeo_4u · #37 02-26-2008, 08:02 PM

Holy crap you finally updated vbexternal.

*Bows down and cries in happiness*

pewp · #38 02-28-2008, 05:22 AM

The thread posts block is not parsing images. it just shows a clickable link when i use the [ img ] [ /img ] tags

enjoymarcus · #39 03-08-2008, 12:45 AM

Hi, great mod. I'm having trouble however, for some reason or another this script is pulling through more than just the block, and I'm finding title, html, head, and body tags appearing in my source, which is of course causing conflicts. How would I go about preventing said tags being pulled through? thanks.

Triky · #40 03-19-2008, 04:21 PM

I will try it.

MrToasty · #41 03-21-2008, 03:24 PM

Quote:

Originally Posted by Fraik

I'm having an issue... trying to create a news block but when I type in the number of posts to display and save it resets again, so its displaying all the posts!

Edit: When just displaying threads the number limit works just fine, it just doesn't work for thread posts

Same here...

My block has the following entered into the DB, any ideas which part of the string is the problem? Or is it the file doing the parsing where the issue is?

Code:

a:12:{s:11:"maxpthreads";s:1:"5";s:12:"maintainperm";s:1:"0";s:6:"bbcode";s:1:"1";s:6:"forums";a:1:{i:0;s:2:"31";}s:10:"filtertext";s:0:"";s:10:"filtertype";s:5:"title";s:7:"orderby";s:4:"date";s:8:"orderdir";s:4:"desc";s:5:"range";s:3:"all";s:8:"maxtitle";s:0:"";s:11:"maxusername";s:0:"";s:8:"maxposts";s:0:"";}

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.05135 seconds Memory Usage 2,427KB Queries Executed 25 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (5)bbcode_code (6)bbcode_php (3)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!