Tutorials

[Adriano Faria]

View File

Tutorials

---

A full-featured Tutorials/Article system for your IP.Board. Here's a quick rundown of some of the features for this application:

• Unlimited categories of articles, plus unlimited depth of parent-child relationships
• Ability to use comments system or support topics, or both
• Per-category permissions to show category, read articles, submit articles, add comments, and avoid approval queues
• Numerous group permissions on various actions
• Moderator actions on articles and comments
• Ability to create RSS feeds of all tutorials, and selected categories
• Application breadcrumb tied to Application Public Title (Admin CP). That means if you change the application public title, will change the breadcrumb in whole app.
• Ability to attach files to tutorials
• Integration with IP.Board's Report Manager
• Ability to create multi-paged tutorials
• Included portal plugins for random, popular, and recent tutorials
• Adds a 'Tutorials' tab to Member Profiles showing their submissions [*]Sidebar hook showing recent tutorials
• Hook to quickly convert a forum post into a new tutorial
• Ability to copy a tutorial from one category to another
• Friendly URLs for tutorials and categories
• Ability to give reputation points for tutorials
• Integration with the board search + Sphinx search support
• Rate tutorials, or follow them to receive notifications on updates
• Integration with IP.Board's Share Links system to share, download, or print articles
• Get notifications for approved/rejected submissions, and when your articles get new comments
• Integration with the Track Members app
• Integration with the Content Spy app
• Integration with the Queued Items hook
• Integration with the IP.Board's sitemap system to include tutorials in your forum's sitemap
• And much, much more!

 
Report Bugs and Suggest New Features Here
 
For those who wants to test the application, go to SOS Invision and use the credentials:

• User: tutorial_user
• Password: 111111
• Category: http://forum.sosinvision.com.br/index.php?app=tutorials&cat=59

You have moderator rights on this category. The board has English but the application is translated. Due to IP.Board limitation on app translations, can't use English on Tutorials 'cause this is my live board.

---

• Submitter
  Adriano Faria
• Submitted
  09/29/2009
• Category
  User and Social Engagement
• Discussion URL
• Support Info
  <p>Support only in support topic.</p>
• Supported Versions
  0,IP.Board 3.2.x,IP.Board 3.3.x,IP.Board 3.4.x

[Connor T]

I thought I'd post the feature list which is on this post.

http://forums.coders...t__0&#entry3425

Here's a quick rundown of some of the features for this version:

• Unlimited categories of articles, plus unlimited depth of parent-child relationships
• Ability to use comments system or support topics, or both
• Per-category permissions to show category, read articles, submit articles, add comments, and avoid approval queues
• Numerous group permissions on various actions
• Moderator actions on articles and comments
• Ability to create RSS feeds of all tutorials, and selected categories
• Ability to attach files to tutorials
• Integration with IP.Board's Report Manager
• Ability to create multi-paged tutorials
• Included portal plugins for random, popular, and recent tutorials
• Adds a 'Tutorials' tab to Member Profiles showing their submissions
• Sidebar hook showing recent tutorials
• Hook to quickly convert a forum post into a new tutorial
• Ability to copy a tutorial from one category to another
• Friendly URLs for tutorials and categories
• Ability to give reputation points for tutorials
• Integration with the board search + Sphinx search support
• Rate tutorials, add them to a favorites list, quickly bookmark them
• Ability to download a tutorial in either Word or HTML format, or print it
• And much, much more!

Very great mod. Haven't purchased myself yet, but spent enough time testing it to know. This is probably the best 3rd party application to utilize all features of IPB3. From FURL to Integrated search, report manager. Just lots of tiny things that separate this from the rest.

[Michael]

I've just updated this to 1.0.0 final, so if you were waiting for the final release to purchase this, now's the time. :)

[Zepher]

Looks awsome. Could this be used for a multi-page article system? Also how detailed is the reviews module. I see you can add favorites and rate articles, just wondering what options there were for reviews.

[Michael]

There is the ability to create multi-paged articles, you just put [pagebreak] in the article where you want this page to break, and then when the article is in the system there will be the page jump at the bottom of it so folks can navigate between pages.

There isn't really a reviews module in this. There is a comment system where people can leave comments, or you can have each article get a support topic created, but the closest thing there is to 'reviewing' articles is being able to give them a star rating.

[Michael]

Updated to version 1.0.1, a few bug fixes and some small features added.

Read More: http://forums.codersrefuge.com/topic/1129-im-tutorials-101/

[Ravage]

michael can u please check your paypal account? i have sent the payment and i didnt got any answer from u so far.

txs mate

[Michael]

You bought the IP.Board 2.3 version of this mod, can you please confirm which version you meant to buy?

[Ravage]

sorry man i was away for a few days. i got it already and working just fine

i wonder if its possible to add color to nicks that appear in the sidebar

i am using tformat groups in my forum, so all members groups have a different color

but on recent added tutorials sidebar it only shows nicks with white colors. is it possible to mod the .xml for that sidebar content?

here is the recentarticles.xml code

<?xml version="1.0" encoding="utf-8"?>

<hookexport>

  <hookdata>

    <config>

      <hook_name>(IM) Tutorials: Recently Added Articles</hook_name>

      <hook_desc>Shows the last X recently added articles in a sidebar hook</hook_desc>

      <hook_author>Michael McCune</hook_author>

      <hook_email>michael.mccune@gmail.com</hook_email>

      <hook_website>http://forums.codersrefuge.com/</hook_website>

      <hook_update_check/>

      <hook_requirements><![CDATA[a:4:{s:20:"hook_ipb_version_min";i:30000;s:20:"hook_ipb_version_max";i:0;s:20:"hook_php_version_min";s:1:"0";s:20:"hook_php_version_max";s:1:"0";}]]></hook_requirements>

      <hook_version_human>1.0.1</hook_version_human>

      <hook_version_long>10001</hook_version_long>

      <hook_extra_data>b:0;</hook_extra_data>

      <hook_key>tutorialsRecentlyAdded</hook_key>

    </config>

  </hookdata>

  <hookfiles>

    <file>

      <hook_file_real>tutorialsRecentlyAdded.php</hook_file_real>

      <hook_type>templateHooks</hook_type>

      <hook_classname>tutorialsRecentlyAdded</hook_classname>

      <hook_data><![CDATA[a:6:{s:15:"classToOverload";s:0:"";s:9:"skinGroup";s:11:"skin_boards";s:12:"skinFunction";s:18:"boardIndexTemplate";s:4:"type";s:7:"foreach";s:2:"id";s:11:"side_blocks";s:8:"position";s:9:"outer.pre";}]]></hook_data>

      <hooks_source><![CDATA[<?php


class tutorialsRecentlyAdded

{

	public $registry;

	public $settings;

	public $DB;

	public $lang;


	public function __construct()

	{

		$this->registry =  ipsRegistry::instance();

		$this->settings =& $this->registry->fetchSettings();

		$this->DB       =  $this->registry->DB();

		$this->lang     =  $this->registry->getClass('class_localization');

	}


	public function getOutput()

	{

		/* Init */

		$return  = "";

		$cat_ids = array();

		$rows    = array();


		/* Language */

		$this->registry->class_localization->loadLanguageFile( array( 'public_external' ), 'tutorials' );


		/* Load library */

		require_once( IPSLib::getAppDir( 'tutorials' ) . '/app_class_tutorials.php' );

		$app_class_tutorials = new app_class_tutorials( ipsRegistry::instance() );


		/* Allowed categories... */

		if ( count( $this->registry->tutorialsLibrary->myCats ) )

		{

			foreach ( $this->registry->tutorialsLibrary->myCats as $id => $r )

			{

				$cat_ids[] = $id;

			}

		}


		/* Got some categories? */

		if ( count( $cat_ids ) )

		{

			/*Query for the articles */

			$this->DB->build( array( 'select'   => 'a.a_id, a.a_name, a.a_name_seo, a.a_date',

									 'from'     => array( 'tutorials_articles' => 'a' ),

									 'where'    => 'a.a_approved=1 AND a.a_cat IN ('.implode( ',', $cat_ids ).')',

									 'add_join' => array( 0 => array( 'select' => 'm.member_id, m.member_group_id, m.members_display_name, m.members_seo_name',

																	  'from'   => array( 'members' => 'm' ),

																	  'where'  => 'm.member_id=a.a_mid',

																	  'type'   => 'left' ) ),

									 'order'    => 'a.a_date DESC',

									 'limit'    => array( 0, $this->settings['tutorials_hook_num_recent'] ),

							)	   );

			$this->DB->execute();


			while ( $row = $this->DB->fetch() )

			{

				$rows[] = $row;

			}


			/* Add our skin template */

			$return .= $this->registry->output->getTemplate( 'tutorials_external' )->hookRecentArticles( $rows );

		}


		/* Return */

		return $return;

	}	

}]]></hooks_source>

    </file>

  </hookfiles>

  <hookextras_settings/>

  <hookextras_language/>

  <hookextras_modules/>

  <hookextras_help/>

  <hookextras_templates/>

  <hookextras_tasks/>

  <hookextras_database_create/>

  <hookextras_database_alter/>

  <hookextras_database_update/>

  <hookextras_database_insert/>

</hookexport>

[Michael]

Updated this app to version 1.0.2 today, more info available here:

http://forums.codersrefuge.com/topic/1473-im-tutorials-102/

[Olivier Turbis]

Thanks Mike. I have to say this mod is the best mod I've seen for IPB so far. So perfect.

[Michael]

Glad you like it. :)

[Cody Bonney]

Hey Mike,
Just installed the mod. I can view it fine from my administrator account but my members still can't access it. Could you tell me where I can change the permissions for this?
Thank you very much!

[Michael]

On the Admin CP Members tab, click on Manage User Groups to edit the basic user group permissions for each group (when you click on a group to edit it, there will be a tab at the top of that form for Tutorials system permissions), and in the Manage User Permissions page you can edit the per-category permissions for each permission mask.

Would you mind me asking which user you are over at my forum? Your name's not familiar to me, and I just want to be sure I'm actually taking to one of my existing customers.

[Cody Bonney]

On the Admin CP Members tab, click on Manage User Groups to edit the basic user group permissions for each group (when you click on a group to edit it, there will be a tab at the top of that form for Tutorials system permissions), and in the Manage User Permissions page you can edit the per-category permissions for each permission mask.

Would you mind me asking which user you are over at my forum? Your name's not familiar to me, and I just want to be sure I'm actually taking to one of my existing customers.

Hey Mike,
Thanks for your help, that worked like a charm.
I registered at your forum under this same name. The thing is, I didn't notice that you charge for that mod before I installed it.
I can't really afford it right now so I've removed it from my site. It was also kind of buggy with my theme.
Anyway, nice work man, it's definitely a sweet modification.

[chopin]

Is there a way for the admin/moderator to change the title of a tutorial, or delete one? If no, I suggest adding this feature.

[Loren]

Is there a way for the admin/moderator to change the title of a tutorial, or delete one? If no, I suggest adding this feature.

You can already do that - admins can just click on Edit. Editing is similar to forum so it's easy.

[chopin]

I suspected that. Hmm, I don't see any mod abilities, I wonder why? Perhaps these abilities are not shown when converting forum topics to tutorials? I haven't created a tutorial yet, I only transferred topics over. The problem is, I transferred over a test topic, so now I can't remove it.

[Michael]

Did you set up all of the group permissions? There are some in there that give certain groups the ability to edit other members' tutorials.

[chopin]

When I go into Categories --> Edit Category --> Permissions, the only columns I see are:

"View Category, Read Tutorials, Submit Tutorials, Add Comments, Auto-Post"

Where am I supposed to look? I don't see any option to edit tutorials.

[Michael]

In the Admin CP, on the Members tab, click 'Manage User Groups'. Click on a group, then look for the (IM) Tutorials tab at the top of that form.

[chopin]

Completely missed that, thanks, that solves it.

[Michael]

It is off on its own there, and a lot of people miss it. The next release of this app will include a section on the Overview page that will let you quickly jump to these group settings.

[THE RED DRAGON]

Can you embedd a JW player with this?

[Michael]

You can do anything with this that you could do with IP.Board. If posting that player requires posting HTML, then just allow certain groups to post HTML (there is a dedicated group setting in this app for who can post HTML in tutorials) and you can use that to post that player in a tutorial. If it's something that a special bbcode could be created for, then it too would work in this app.