Simple Machines Community Forum

---

---

Introduction
Well, we all know how helpfull the SMF helppages can be.
But, what if we install a big mod creating a huge new forumfunction?
The users won't have a clue on how thing work on this new place.
You can change this  now.

Using this modification you can add up to 10 new helppages and choose which of the default SMF pages to be used.
You can choose the name and content of each new page, and use both HTML and BBC in them.
In addition, you can add up to 5 side blocks displayed to the left of the helppages, right under the custom helpmenu.

Note that this is a early beta version of this mod and that constant updates will occur.
Also note that that this mod is very simply coded, and won't have unlimited pages etc before I have learned more.

Features
Admin Panel
o Enable/disable the help page
o Choose title of the Help button in the navigation menu
o Create up to 10 help pages whit custom names and HTML content.
o Disable/Enable each custom page as you like
o Add up to 5 HTML blocks at the left side of the helppages.
o Disable/Enable each block as you like
o Choose which of the default SMF helppages to use along whit your custom ones.

Preview
See the attached images for a preview.

Tested
Fully tested on a fresh installation of SMF 2.0 RC1.
The codes of the 1.1.x version was also tested, but not the installation package.

Tinyportal users
Try this (http://www.simplemachines.org/community/index.php?topic=270529.msg1846132#msg1846132) if you want to have a link to the TP helppages among the new ones.

Thank's to
genieuk
o Basic idea and mod name
o Feature ideas
Deprecated
o BCC support
o General coaching and encouragement
Costa
o Former translator (Brazilian)
Those who have commented and used

Languages
o English
o Swedish
If you want to join us and translate all future updates of this mod, write in this topic.

Changelog
1.0 Beta 1 Build 0.8.2a 6 February
o Added support for SMF 2.0 RC1.
o Removed support for SMF 2.0 Beta 4. This version shouldn't be used any longer.
Changelog
1.0 Beta 1 Build 0.8.1a 23 December 2008
o Just removed a unneeded variable. It won't affect the looks of the mod in action. (Don't ask me why I've put it there anyway)
o Added a few comments in the template file, find them and be suprised :P
1.0 Beta 1 Build 0.8f 21 December 2008
o Rewrote the menu:
  o Made the current page marked
  o Cleaner code
o New admin options:
o Choose color of current page in the menu
o Choose the titles of the default SMF helppages
o Rewrote 1.1.x version from scratch:
o New adminpanel finally available
o Now fully tested
o Rewrote the blocks:
  o Made code cleaner in the tempalte file, now using one pease of code for all blocks instead of one for each block.
  o Removed the <b> making the blockcontent bold and awful.
o Edited a few lines in the adminpanel to make the smf default pages work whit the new way of displaying the menu.
  o Updated some of the stringnames in the language file to make the texts in this area display.
o Removed the input boxes for blocks that where displayed twice under the inputs for pages. (Left since the version whit all inputs on the same page)

1.0 Beta 1 Build 0.7.1a 20 December 2008
o Added headlines to the pages, dispalying the name of the current page at the top of it.
o Added a TinyPortal package for SMF 1.1.x (Untested, whitout the new adminpanel)

1.0 Beta 1 Build 0.7d 19 December 2008
o You can now add 5 blocks instead of 3.
o Added swedish translation.
o Removed brazilian translation, as Costa (the translator) has left SMF due to real life issues.
o Added a feature allowing you to keep the SMF default helppages as they are. You can also disable any of them if you don't want it.

1.0 Beta 0.6.1 2nd November 2008
o Fixed the look by moving the help navigation menu to a new block at the left side instead.

1.0 Beta 0.6.0 27th October 2008
o *SMF 2.0 Beta 4 only* Moved the help page administration from Admin > Configuration > Modifications to Admin > Configuration > Help Pages.
o Added BBC support. Thank's to Deprecated (http://www.simplemachines.org/community/index.php?action=profile;u=166492)
o Added a redirect after installation.

1.0 Beta 0.5.3 31th October 2008 (Halloween) (http://files.nascar.vlexo.net/mppumpkin.gif)
o Added brazilian translation.

1.0 Beta 0.5.2 26th October 2008
o Original beta realese.

Thank you Nascar  :D

My Dream has come true, i have been dying for a mod like this, this mod will rock!!! now i can make custom help pages that relates to my forum only and information i put in will be true and not inaccurate. As i have made so many changes to my site alot of information is no longer accurate, this mod solves that by allowing us to make our own help pages, also it gives such great ability to better the help section. At the moment the layout is poor, again this mod solves that by making things easier to find and understand.

All i can say is you rock, the mod will definately rock and WOW!

Am going to install now,  :D

I am like a kid wih a new toy, can't wait to install quick enough, let me of course backup first ;) then i will let you know how it goes on SMF 1.1.6

Kindest Regards,
Mathew

Hi Nascar,

It failed on index.template.php and modsettings.php. Only reason for this was thou because i have a heavy modded site and had to add code manually using package parser. This was not a problem.

Silly question, where is the section in admin for edit of help pages ??? i cannot find it anywhere, i am using SMF 1.1.6 as you know.

Thank you,
Mathew

Admin > Features & Settings > Help Pages

Quote from: Nascar on October 26, 2008, 11:36:28 AM
Admin > Features & Settings > Help Pages

Strang it not showing in my Features & Options > Help Pages, Help pages not showing.

Please see attached image.

Are you sure you edited ModSettings.php the right way?
Attach it, please.

Quote from: Nascar on October 26, 2008, 11:43:48 AM
Are you sure you edited ModSettings.php the right way?
Attach it, please.

Hi,

I had to edit it manually because some things was not found because so many mods, i am very sure i edited fine. Maybe it is because the package parser i am using is in Beta not sure, probably is me thou. http://resourcez.biz/PackageParser/index.php

File attached.

Hi,

It working now,  :D

I had to instances of where it says find:

loadLanguage('ModSettings');

so added it in two places in the file.

Mathew

Glad you've fixed it. Let ,e know what you think about the mod when you've tried it out.

Nice work Nascar. But why don''t you submit it at the mod site as well?

I'm not 100% done whit it, but I wanted to share it anyway :)
As fast as I've added the features I want and fixed a few problems I'll submit it to the mod site.

Quote from: Nascar on October 26, 2008, 12:01:38 PM
I'm not 100% done whit it, but I wanted to share it anyway :)
As fast as I've added the features I want and fixed a few problems I'll submit it to the mod site.

Ah, ok. Thanks for your answer and keep up the good work :)

Quote from: Nascar on October 26, 2008, 11:58:12 AM
Glad you've fixed it. Let ,e know what you think about the mod when you've tried it out.

Well it is perfect no problems with SMF 1.1.6, two failures but if your site is heavily modded then manual edit maybe required.

I have tried it and no errors or problems at all, I LOVE IT I have used 9 help pages already just got to add content to them now,

If people wants to see how this really does work, visit my help section, at the time of writing this i have not added content only the pages i have enabled and created my own titles, so dont expect perfection, but keep checking back if you want and you will see over time it will look perfect, thanks to Nascar ;)

http://www.foreverlastingfriends.com/index.php?action=help

All i need to do is remove the drop down menu from the help page.

PERFECT! ,

Thanks
Mathew

Glad you like it.
As you may see, the table whit information is pushed a bit to the right, even thou you have no blocks. That's one of the thing I'll fix before I submit this as a mod.

Well i am going like mad,

I have created a contact us page and created a contact us form which checks and validates information has been entered and redirects user to forum once submitted form. If information is not entered then they are told they need to enter information etc.

I Love it :)

http://www.foreverlastingfriends.com/index.php?action=help;page=10

Small update
Added abillty to remove the bottom menu at the help page.
(Help.template.php, HelpPage.english.php and ManageSettings.php/ModSettings.php updated)

I am not bothering to update as happy with it, will update when more features become available.

I am loving it, my help section is exactly how i want it http://www.foreverlastingfriends.com/index.php?action=help

I also changed the links on the drop down menu so i could keep the drop down menu for the help button.

What you think Nascar ??? you should be proud of this mod  :D ,

Like i said before if anyone wants to see what the fantastic things this mod can do check out my help section on above link.

Mathew

Awesome mod nascar , really useful

Good idea but...

It would be better to create custom table for help pages to allow unlimited number of pages, this would also make code better since you would need only one code for all pages.

Maybe this could be done with loops also, one disadvantage is that all pages will be in memory every page load and with more pages it could go over limit sometimes. (depends on limit that server has)

Yes, Niko, I was thinking about updating it like that.
Currently I'm making users able to comment each help page (only admin can see the comments).

Quote from: Nascar on October 30, 2008, 01:45:45 AM
Yes, Niko, I was thinking about updating it like that.
Currently I'm making users able to comment each help page (only admin can see the comments).

Doh! you should keep these as a suprise, lol

Mathew

hello,

I tried installing your mode but I received this error code

./Themes/default/index.template.php Test failed  

what canI do to fix it?

http://forum.learnhomebasedbusiness.com/

Quote from: wilsond on October 30, 2008, 03:13:27 PM
hello,

I tried installing your mode but I received this error code

./Themes/default/index.template.php Test failed  

what canI do to fix it?

http://forum.learnhomebasedbusiness.com/

basically you need to install via package manager as normal, all it does it skip the file, then manually add the code to the index.template.php file. Go to mod link , select your smf version and it will tell you what to do for the index.template.php file.

Or alternatively upload your index.template.php file.

Mathew

No, genieuk, this is Enhanced Custom Help Pages mod, not Posting Announcement ;)

wilsond: Simply instal lthe mod any way, and then attach the index.template.php file of your current theme.

Quote from: Nascar on October 30, 2008, 03:56:06 PM
No, genieuk, this is Enhanced Custom Help Pages mod, not Posting Announcement ;)

wilsond: Simply instal lthe mod any way, and then attach the index.template.php file of your current theme.

I must have clicked on something when checking, i have edited my post, good job for you pointing it out. Lack of sleep  ::)

Mathew

ok thanks here it is attached.   :)

Hmm.. The file you attached is already edited? The mod should work now?

oh my goodness my site crashed..take a look the links don't work anymore ..click on any of the topics help please...
http://forum.learnhomebasedbusiness.com/index.php

That is not related to this mod.

Quote from: wilsond on October 30, 2008, 05:05:08 PM
oh my goodness my site crashed..take a look the links don't work anymore ..click on any of the topics help please...
http://forum.learnhomebasedbusiness.com/index.php

Nascar is right. Did you do any modifications at all prior to getting that error?

Quote from: Nascar on October 30, 2008, 01:45:45 AM
Yes, Niko, I was thinking about updating it like that.
Currently I'm making users able to comment each help page (only admin can see the comments).

Nice feature for the help page

But is really important to have unlimited number of pages

Also you can add a little ticket system

Quote from: NIBOGO on October 30, 2008, 05:22:05 PM

Quote from: Nascar on October 30, 2008, 01:45:45 AM
Yes, Niko, I was thinking about updating it like that.
Currently I'm making users able to comment each help page (only admin can see the comments).

Nice feature for the help page

But is really important to have unlimited number of pages

Also you can add a little ticket system

There are some suprises instore for this mod, things will improve over time, Nascara, i recommend you not say what is coming and keep it a secret as i think the ideas i told you about for future releases should be left as a suprise. ;)

Mathew

I am taking down the site and do a fresh install then go from there

Quote from: NIBOGO
Nice feature for the help page

But is really important to have unlimited number of pages

Also you can add a little ticket system

That's right! It's very usefull unlimited pages.
Note that it's not a critic, it's one sugestion
anyway, were is the files to translate ??? :P
Congrats for the mod Nascar, is very useful  ;D

Farewell
- Costa

The file is included in the package that is attached to the first post.
It's called HelpPage.english.php.
There's no changes in Modifications.{language}.php or any other lanugage files.

I've got an error during installation

./Sources/ModSettings.php Test Fail
./Themes/default/index.template.php Test Fail

I use another themefor my fórum too (dilber MC)

in the attachment goes the brazilian translation

Please attach the ModSettings.php file, and the index.template.php from the dilber mc theme.

Thank's for the translation!

Will you be interested ni translating the future versions of this mod?
Therw will be constant changes in the langauges strings untill the mod is out of its beta.

Quote from: Nascar
Please attach the ModSettings.php file, and the index.template.php from the dilber mc theme.

they are attach to this post, both, from default and dilberMC
*they are in brazilian  :P

Quote from: Nascar
Thank's for the translation!

You're welcome

Quote from: Nascar
Will you be interested ni translating the future versions of this mod?
Therw will be constant changes in the langauges strings untill the mod is out of its beta.

Of course. Be my guest.

Farewell
- Costa

Here's the index.template.php for dilber mc.

I need the ModSettings.php file from ./Sources/ irectory, not the language file.

I already do that Nascar, is see the error :P
In my post before i correct the files :P

Tank You

Farewell
- Costa

Use this:

Don1t appear nothing to me in admin...

It's in Admin > Features & Settings > Help Pages

No, what's the link?

?action=featuresettings;sa=helppage

Ok, I know what's happen

This mod have a conflict with another mod (Baker Dozen pages)
One of the another admins install that mod, and now i have a conflict :P

I see the bakers dozen pages today, and i translate them, but not install
One of my admin install ¬¬

1.0 Beta 0.6.0 27th October 2008
o *SMF 2.0 Beta 4 only* Moved the help page administration from Admin > Configuration > Modifications to Admin > Configuration > Help Pages.
o Added BBC support. Thank's to Deprecated (http://www.simplemachines.org/community/index.php?action=profile;u=166492)
o Added a redirect after installation.

Looks like it's shaping up to be an awesome mod. Any idea when you'll get it out of beta and approved as an official mod?

Quote from: antechinus on November 01, 2008, 07:27:07 PM
Looks like it's shaping up to be an awesome mod. Any idea when you'll get it out of beta and approved as an official mod?

There are loads more to come to this mod and they are fab, i think Nascar is going to wait until the next bunch of features are added. I am so excited I can't wait  :D ,

I won't say what they are incase Nascar wants to keep them a secret.

Mathew

Quote from: antechinus on November 01, 2008, 07:27:07 PM
Looks like it's shaping up to be an awesome mod. Any idea when you'll get it out of beta and approved as an official mod?

Thanks for the comment :)
As genieuk said, I have a few more features left to do before it's out of beta.
Probably a few weeks.

1.0 Beta 0.6.1 2nd November 2008
o Fixed the look by moving the help navigation menu to a new block at the left side instead.

Quote from: Nascar on November 02, 2008, 01:31:04 PM
1.0 Beta 0.6.1 2nd November 2008
o Fixed the look by moving the help navigation menu to a new block at the left side instead.

Yes much better now and better for users who use small resolutions,

fixes the problem with small resolutions when links on top go underneath each other and more organized on left hand side :)

Mathew

 :-[

I cant view the install page !

I just get the coded page rather than a "useable" page

What am I missing ?

also I cant install via package manager

1.1.7
tiny portal
SMF MediaGallery.

test board        www.uklows.com/test

Could you please explain your issues a bit furtger?

if i open the xml file I see this.........

(http://www.uklows.com/test/Image1.jpg)

when I try to use package manager the page just returns to the "packages" page instead of loading the mod

Can you tell me where my code is off in this Help.template.php file please, it skipped the file on install and my manual install of the code is not correct.
It shows this error when trying to access the new help page.
Parse error:  syntax error, unexpected $end in .../Themes/default/Help.template.php on line 27492740:       <li>', $txt['manual_searching_three_options_part1'], '<a href="', $scripturl, '?action=help;page=searching#syntax">', $txt['manual_searching_three_options_link_syntax'], '</a>', $txt['manual_searching_three_options_part2'], '</li>
2741:       <li>', $txt['manual_searching_wildcard'], '</li>
2742:       <li>', $txt['manual_searching_results_as_messages'], '</li>
2743:       <li>', $txt['manual_searching_message_age'], '</li>
2744:       <li>', $txt['manual_searching_which_board'], '</li>
2745:       <li>', $txt['manual_searching_search_button'], '</li>
2746:    </ul>';
2747: }
2748:
2749: ?>2750:
2751:



My test site is located HERE. (http://www.ourfamilyforum.org/tptest2/index.php)

This one should work:

That works, thanks! :)

In This Post (http://www.simplemachines.org/community/index.php?topic=270529.msg1769250#msg1769250) genieuk give a link to his help pages where he has included parts of the default SMF help page... is there an easy way to do this or must the pages be copied/coded manually?

Also, a Feature Request: 
Is it possible to include the entire SMF default help under one tab or link?
And if it is could the TinyPortal help pages be included in the same manner?

Thanks for this great Mod Nascar.  :)

Currently you have to copy and paste.
Maybe I could include feature like that :)

That would be great, the default pages are useful to some members. :)

Quote from: iain sherriff on November 12, 2008, 08:53:41 AM
if i open the xml file I see this.........

(http://www.uklows.com/test/Image1.jpg)

when I try to use package manager the page just returns to the "packages" page instead of loading the mod

I reinstalled 1.1.6, added ECHP then updated to 1.1.7 and it was OK.
just as a check i did it again with 2.2.7 in the first place and it wouldn't install ?

anyway its in now and works, just what I wanted

thankyou

Wow I think this mod just jumped up there among my favorites-
I tried it on my test board.

I do have some suggestions - hopefully these are in the works before submission-

• Tiny Portal support- I saw the TP tab was mention. I dont need that. I would just like to see it reconize that TP is there. I get errors for all the pages on install because of TP. It actually was an easy manual install but just something for the folks scared to manual edit after adding the package.
  
• An easier way to incorporate some of the old HELP. For some reason the HTML doesnt work well. I pulled the HTML from the original help page added it in and everything is off. The HTML is correct correct because I added it in a TP Article and everything matched up. Is it perhaps that everything is off because of the extra Navigation block?

Nonetheless- this one is looking good- Looking forward to seeing it on the Mod Page!

Thank's for the comments and suggestions.
I'm thinking of a good way to include the old help pages, and it will be included in the next release.

Just to remind that we already have these two mods in the Mod Site:

http://custom.simplemachines.org/mods/index.php?mod=1311
http://custom.simplemachines.org/mods/index.php?mod=1477

I suggest spending your time on a different mod, unless you are planning to add some different features to this. ;)

Weel, I have plenty of features going on. Like a r***** s*****, c****** etc :P

You wouldnt by any chance have a time frame on a release? Also- would it be an upgrade if we install the BETA or would we need to uninstall BETA first?

(now running and hiding for asking a dumb question)

Nascar, I have a request/suggestion for a slightly different approach for your Mod.

First of all let me restate my high praise for your work, this is a great add-on for the SMF help pages and I'm sure your final version is going to be well received.  :)

My suggestion may be out of line with your current focus and I'm no coder so this may not work as envisioned but heres my thought... FWIW.

The current SMF help pages are good to have as part of anyones forum so it's good that you are working to include them in your next release, but imho it might work well if you do it the other way around... in other words, have your mod be an add on for the existing SMF help pages much the way that Bloc has done for the TinyPortal help pages.
By adding an extra tab (or tabs) to the SMF help page and then having sub-pages available for each tab page you would accomplish your goal while leaving the SMF page intact.

Thanks... Ken.

Hmm, interesting Nascar. Good job so far, and it looks like a good mod.

Yes, this is a shameless post to get this on my unread list. :P

Quote from: Ken. on November 20, 2008, 04:55:05 AM
Nascar, I have a request/suggestion for a slightly different approach for your Mod.

First of all let me restate my high praise for your work, this is a great add-on for the SMF help pages and I'm sure your final version is going to be well received.  :)

My suggestion may be out of line with your current focus and I'm no coder so this may not work as envisioned but heres my thought... FWIW.

The current SMF help pages are good to have as part of anyones forum so it's good that you are working to include them in your next release, but imho it might work well if you do it the other way around... in other words, have your mod be an add on for the existing SMF help pages much the way that Bloc has done for the TinyPortal help pages.
By adding an extra tab (or tabs) to the SMF help page and then having sub-pages available for each tab page you would accomplish your goal while leaving the SMF page intact.

Thanks... Ken.

without wanting to critiscise what you are doing in any way NAscar I to like the way TP use the tab

As you know I was cancelnig this mod, but after the comments I got from a few people I decided to keep working on it.

1.0 Beta 1 Build 0.7d 19 December 2008
o You can now add 5 blocks instead of 3.
o Added swedish translation.
o Removed brazilian translation, as Costa (the translator) has left SMF due to real life issues.
o Added a feature allowing you to keep the SMF default helppages as they are. You can also disable any of them if you don't want it.

Note
1.1.x users
Only the old versions of this mod is currently available for SMF 1.1.x.
This is due to the lack of time I have to code this mod, so I find it easier to finnish the mod for SMF 2.0 and then convert it for 1.1.x.

Great job buddy , keep working in this mod ^^

Quote from: Ken. on November 20, 2008, 04:55:05 AM
Nascar, I have a request/suggestion for a slightly different approach for your Mod.

First of all let me restate my high praise for your work, this is a great add-on for the SMF help pages and I'm sure your final version is going to be well received.  :)

My suggestion may be out of line with your current focus and I'm no coder so this may not work as envisioned but heres my thought... FWIW.

The current SMF help pages are good to have as part of anyones forum so it's good that you are working to include them in your next release, but imho it might work well if you do it the other way around... in other words, have your mod be an add on for the existing SMF help pages much the way that Bloc has done for the TinyPortal help pages.
By adding an extra tab (or tabs) to the SMF help page and then having sub-pages available for each tab page you would accomplish your goal while leaving the SMF page intact.

Thanks... Ken.

The latest version of the mod allows you to keep the default helppages intact.

Quote from: Eliana Tamerin on December 11, 2008, 08:14:04 AM
Hmm, interesting Nascar. Good job so far, and it looks like a good mod.

Yes, this is a shameless post to get this on my unread list. :P

Thanks, Eliana!

Quote from: iain sherriff on December 12, 2008, 02:57:48 PM

Quote from: Ken. on November 20, 2008, 04:55:05 AM
Nascar, I have a request/suggestion for a slightly different approach for your Mod.

First of all let me restate my high praise for your work, this is a great add-on for the SMF help pages and I'm sure your final version is going to be well received.  :)

My suggestion may be out of line with your current focus and I'm no coder so this may not work as envisioned but heres my thought... FWIW.

The current SMF help pages are good to have as part of anyones forum so it's good that you are working to include them in your next release, but imho it might work well if you do it the other way around... in other words, have your mod be an add on for the existing SMF help pages much the way that Bloc has done for the TinyPortal help pages.
By adding an extra tab (or tabs) to the SMF help page and then having sub-pages available for each tab page you would accomplish your goal while leaving the SMF page intact.

Thanks... Ken.

without wanting to critiscise what you are doing in any way NAscar I to like the way TP use the tab

Read what I wrote erlier in this post

Quote from: TheDel on November 19, 2008, 03:49:57 AM
You wouldnt by any chance have a time frame on a release? Also- would it be an upgrade if we install the BETA or would we need to uninstall BETA first?

(now running and hiding for asking a dumb question)

No, no time frame currently.
Currently you have to uninstall the beta first, but there will be no data lost.
i might add a upgrader when I finish the mod.

Quote from: NIBOGO on December 19, 2008, 01:29:13 PM
Great job buddy , keep working in this mod ^^

Thank you.

It's great to see you working on this Mod again Nascar!  8)

I'm trying to install too my test forum (http://www.ourfamilyforum.org/tptest2/index.php) that also has the TinyPortal help pages installed.

During the install process the help.php and help.template.php files both failed so those two received a manual edit but there is a conflict and so far I'm not getting it sorted out, here's the error that it throws when the help page is accessed.

Quote
Parse error:  syntax error, unexpected $end in ../tptest2/Sources/Help.php on line 111

The help.php and help.template.php files are attached.

Thanks... Ken.

Did you use the latest version of this mod? Its only for SMF 2.0. You need to use the archived release of the mod (at the bottom of the first post in this topic)
If so, you might want to wait a few days for me to update 0.7d to 0.8a which will support SMF 1.1.7 again (1.1.x versions will always be a bit late)

OK, not a problem.  :)

I'll go ahead and try this version on my SMF2.0 test board and wait for the SMF 1.1.7 version.

... I should have paid more attention. :-[

Hhehe :)

Looks like it won't be very long until the 1.1.x update. Not many updates to do in the key files, its mosly the admin panel needing fixes.

The version for SMF2.0 works great!

http://www.ourfamilyforum.org/SMF2.0/index.php?action=help (http://www.ourfamilyforum.org/SMF2.0/index.php?action=help)

It will take a little rework on my article code to get the display correct, but this is going to work nice.

Will there be some way to deal with the TinyPortal help pages being installed to the SMF help pages for those of us who use TP?

I'm glad to see you working on this mod again, Nascar. Keep up the good work!

Quote from: Ken. on December 19, 2008, 03:11:28 PM
The version for SMF2.0 works great!

http://www.ourfamilyforum.org/SMF2.0/index.php?action=help (http://www.ourfamilyforum.org/SMF2.0/index.php?action=help)

It will take a little rework on my article code to get the display correct, but this is going to work nice.

Will there be some way to deal with the TinyPortal help pages being installed to the SMF help pages for those of us who use TP?

Actually I was thinking of making some kind of TP support for it. Keep your eyes open.

Quote from: Eliana Tamerin on December 19, 2008, 03:24:53 PM
I'm glad to see you working on this mod again, Nascar. Keep up the good work!

Thanks :)

That sounds good.  :)

Update
1. The SMF 1.1.x version for this mod is located at the bottom of the first post of this topic. Do not use the ECHP 1.0 Beta 1 Build 0.7d.zip package for 1.1.x.
2. Be aware that the 1.1.x version doesn't have a proper admin panel. Instead, all settings are gathered in one big page.
3. You might want to know that the 1.1.x version never where tested.

Tried it on my SMF 1.1.7 and the test failed on:
./Sources/Help.php
./Themes/default/Help.template.php

I tried uninstalling TinyPortal to see if that would help but it gave the same result.

Is it the same fiels that you attached eriler today?
If so, replace them whit the fiels from the default SMF

Quote from: Nascar on December 19, 2008, 05:04:23 PM
Is it the same fiels that you attached eriler today?
If so, replace them whit the fiels from the default SMF

Tried it with fresh files and tried it with and without TinyPortal being installed and it still gives the same result... haven't tried to do a manual install yet.

Finally got it to install to my SMF 1.1.7 by doing a manual install... on my other attempt one of the file edits must have been missed.

At this point, with the current version it looks as if the only way to install is to do it manually if TinyPortal is to be used as well.
http://www.ourfamilyforum.org/tptest2/index.php?action=help (http://www.ourfamilyforum.org/tptest2/index.php?action=help)

Oh Im so doing a happy dance today
The TP tab would be the one thing I would like to so go. I LOVE TP and the tab explains the functions but at least the members I have had experience with dont know what TP is - its just a website to them. But then again, the members on my site go into a panic and and think its difficult to post pictures even though there is an image there and its there photobucket account that is causing it.

You can try this package for TP and SMF 1.1.x.
It's untested, but if the regular none-TP 1.1.x package works, this one will to.

Quote from: Nascar on December 20, 2008, 03:58:50 AM
You can try this package for TP and SMF 1.1.x.
It's untested, but if the regular none-TP 1.1.x package works, this one will to.

That works. :)

Did an uninstall of the previous version and installed this new .v through the package manager with no problems at all.
The TinyPortal help pages link shows up in the navigation and works as expected.

A couple of notes:
When in the TP help pages the SMF tab shows along with the TP tab... if you click on the SMF tab it redirects to the ECHP 'main' page.
About three pages of errors show up in the error log, but those should likely be disregarded until you release a version with an admin panel.

Works good as is, but the 2.0 style admin panel will be nice to have. ;)

Making the TP help pages look liek the ECHP's would require to rewrite the TP helppages, which is not really want I itend to do whit this mod.

Are all errors the same? Which one?

The TP pages are fine as is, I only mentioned that so that you would be aware.

Here are several entries from the first page of the error files, the first two don't appear (to me) to be related but I left them in anyway:

Quote../tptest2/index.php?action=viewErrorLog;desc
8: Undefined index: 3
File: /home/kenkayjm/public_html/tptest2/Sources/TPortal.php
Line: 474
   

../tptest2/index.php?action=admin
8: Undefined index: 3
File: /home/kenkayjm/public_html/tptest2/Sources/TPortal.php
Line: 474
   

../tptest2/index.php?action=tpmod;sa=help
8: Undefined index: 3
File: /home/kenkayjm/public_html/tptest2/Themes/default/languages/TPShout.english.php (tp_above sub template - eval?)
Line: 36
   

../tptest2/index.php?action=tpmod;sa=help
8: Undefined index: 3
File: /home/kenkayjm/public_html/tptest2/Sources/TPortal.php
Line: 474
   

../tptest2/index.php?action=help
8: Undefined index: index
File: /home/kenkayjm/public_html/tptest2/Sources/Help.php
Line: 80
   

../tptest2/index.php?action=help
8: Use of undefined constant permissiongroup_helppage - assumed 'permissiongroup_helppage'
File: /home/kenkayjm/public_html/tptest2/Themes/default/Help.template.php (eval?)
Line: 104

Quote from: Nascar on December 20, 2008, 03:58:50 AM
You can try this package for TP and SMF 1.1.x.
It's untested, but if the regular none-TP 1.1.x package works, this one will to.

Tried that.. error from PM on Help, Help.template & ModSettings

Can get by with manual edits to Help & ModSettings but my template looks nothing like what your alterations propose

Hello, HR!

First, make sure you did the manual edits of the two other files 100% correct, and after that use this file:

Upcoming
Menurewrite
o Make the current page marked
o Cleaner code
New admin options:
o Choose color of current page in the menu
o Choose the titles of the default SMF helppages
Rewrite 1.1.x version from scratch:
o New adminpanel will finally be available
o Will be fully tested

Sounds great Nascar.  ;D

One note for those of us that have TinyPortal and SMF 1.1.7 installed:
Found that in my case it worked best to replace 'Help.php' and 'Help.Template.php' with fresh SMF default copies of those two files before installing the currently available versions of ECHP.

Probably me making something wrong in the installation package.
I didn't use TP when I made it, and as I said it wasn't tested.

Me not into coding so this may be wrong, but it sounds like your install routine needs to overwrite those two files entirely so as to remove all of the TinyPortal entries in the two.

No ,I don't think so.
I just have to take a look at some fresh TP help files and adjust my installpackage to those.


Anyway, I just finished 1.0 Beta 1 Build 0.8 and I'm ready to release it after I've tested the 1.1.x version.
Then I have to fix the TP version to, of course.

Update
1.0 Beta 1 Build 0.8h

Changelog
o Rewrote the menu:
  o Made the current page marked
  o Cleaner code
o New admin options:
o Choose color of current page in the menu
o Choose the titles of the default SMF helppages
o Rewrote 1.1.x version from scratch:
o New adminpanel finally available
o Now fully tested
o Rewrote the blocks:
  o Made code cleaner in the tempalte file, now using one pease of code for all blocks instead of one for each block.
  o Removed the <b> making the blockcontent bold and awful.
o Edited a few lines in the adminpanel to make the smf default pages work whit the new way of displaying the menu.
  o Updated some of the stringnames in the language file to make the texts in this area display.
o Removed the input boxes for blocks that where displayed twice under the inputs for pages. (Left since the version whit all inputs on the same page)

ECHP 1.0 Beta 1 Build 0.8h (1.1.x and TinyPortal).zip

On this one the install fails as follows:
With TinyPortal installed the file test fails for Help.php and Help.Template.php
With TP uninstalled it fails on Help.Template.php

On a manual install it fails to find this part in the code of the Help.Template.php file:
                <operation>
            <search position="replace"><![CDATA[function template_manual_search()]]></search>
            <add><![CDATA[function template_helppage_search()]]></add>
                    </operation>

Hmm..
Can't see why it doesn't find that.
that part is not necessary if you do not wish to use the search-helppage.

Could you by any chanse attach two fresh copies of Help.php and Help.temaplte.php, whit TP installed?

Ok, after testing this, I've got a few things.

-The "Color of current menuitem" feature doesn't take different themes into consideration. Should give option to disable or use bold/italics/underline instead.

-Your preview images show a space between Page 10 and the General Help page. The current build does not include that. I'd suggest including the ability to accept user input for the divider, such as a <hr /> or <br /> or even a block of text.

-What's the purposes of the blocks? I would suggest allowing dynamic blocks for each page.

-Capped at 10 pages? Are you going to allow the user, eventually, to set up unlimited pages?

-Same as above, but for blocks.

-Title of help pages in menubar doesn't allow for translations. Something to think about, since the default SMF text does get translated.

-Give the ability to choose between an introductory text on the main help page, or to select one of the enabled pages (both the mod's or SMF's defaults) to show.

Hope that helps you, Nascar. BTW, it fails on RC1's Help.php source, so be prepared for a change once SMF RC 1 gets released.

Quote from: Eliana Tamerin
-The "Color of current menuitem" feature doesn't take different themes into consideration. Should give option to disable or use bold/italics/underline instead.

Good idea. I'll have a look at that.

Quote from: Eliana Tamerin
-Your preview images show a space between Page 10 and the General Help page. The current build does not include that. I'd suggest including the ability to accept user input for the divider, such as a <hr /> or <br /> or even a block of text.

It's becasue of all pages being in the same array. Maybe I could have the 10 custom pages in 1 array and the default in one.
Then I could separate the output of each of them.

Quote from: Eliana Tamerin
-What's the purposes of the blocks? I would suggest allowing dynamic blocks for each page.

They where added to allow you to have blocks like "New to our forum? Check out this board" etc.
Dynamic blocks is another good idea

Quote from: Eliana Tamerin
-Capped at 10 pages? Are you going to allow the user, eventually, to set up unlimited pages?

Yes, I will. I just have to learn more first.
Same for blocks

Quote from: Eliana Tamerin
-Give the ability to choose between an introductory text on the main help page, or to select one of the enabled pages (both the mod's or SMF's defaults) to show.

Good idea.

Quote from: Eliana Tamerin
Hope that helps you, Nascar. BTW, it fails on RC1's Help.php source, so be prepared for a change once SMF RC 1 gets released.

Thanks for letting me know. Being prepered :)

Quote from: Nascar on December 21, 2008, 10:47:13 AM
Hmm..
Can't see why it doesn't find that.
that part is not necessary if you do not wish to use the search-helppage.

Could you by any chanse attach two fresh copies of Help.php and Help.temaplte.php, whit TP installed?

OK, here ya go.
If you think it would be helpful for you to have access to this test forum let me know and I'll do an account.

Hmm.. I did one thing wrong in Help.template.php, which is fixed in the new pacakge (attached in this post).
Can't see any other problems.

That installed with no problems at all.

Wish list item:
In the SMF 2.0 version the SMF help is separated from the  Enhanced pages and has  its own heading, "SMF User Help" It would be nice to have that in this SMF 1.1.7 version, plus being able to change the heading text would be nice as well.

Everything seems to work correctly within the pages and the controls, but there are lots of errors thrown in the error log; here's a few of them:

action=viewErrorLog;desc
8: Use of undefined constant permissiongroup_helppage - assumed 'permissiongroup_helppage'
File: /home/kenkayjm/public_html/tptest2/Themes/default/languages/Admin.english.php (eval?)
Line: 204
   
../index.php?action=viewErrorLog;desc
Apply Filter: Only show the errors with the same message
8: Use of undefined constant permissionname_helpblocks_view - assumed 'permissionname_helpblocks_view'
File: /home/kenkayjm/public_html/tptest2/Themes/default/languages/Admin.english.php (eval?)
Line: 202
   
../index.php?action=viewErrorLog;desc
Apply Filter: Only show the errors with the same message
8: Use of undefined constant permissionname_helppage_view - assumed 'permissionname_helppage_view'
File: /home/kenkayjm/public_html/tptest2/Themes/default/languages/Admin.english.php (eval?)
Line: 200
   
../tptest2/index.php?action=viewErrorLog;desc
8: Undefined index: 3
File: /home/kenkayjm/public_html/tptest2/Sources/TPortal.php
Line: 474
   
../tptest2/index.php?action=help;page=loginout
8: Undefined index: enable_block_5
File: /home/kenkayjm/public_html/tptest2/Themes/default/languages/TPShout.english.php (helppage_above sub template - eval?)
Line: 203
   
../tptest2/index.php?action=help;page=loginout
8: Undefined index: enable_block_4
File: /home/kenkayjm/public_html/tptest2/Themes/default/languages/TPShout.english.php (helppage_above sub template - eval?)
Line: 203


Glad it worked.

The header disappeared when I started to use foreach whit the all_pages array.
I could add the echpages in to one array and the deafult into one, and this would fix it.

I'll have a look at all these errors.

Thanks for your efforts on this Nascar.
imho it is a very worthwhile mod. :)

Very small update

Changelog
o Just removed a unneeded variable. It won't affect the looks of the mod in action. (Don't ask me why I've put it there anyway)
o Added a few comments in the template file, find them and be suprised :P

Note
I'm seeking someone who's interested in testing the final build of Beta 1, which has been started working on.

Quote from: Nascar on December 23, 2008, 05:13:59 AM

Note
I'm seeking someone who's interested in testing the final build of Beta 1, which has been started working on.

My test forum is available.  :)

Nascar, I'm up for helping you.

Thank you both.
It won't be soon though. I'll probably rewrite the entire mod, make it use the databse and introduce unlimited pages and blocks, and right side blocks.

I will start to finalize this as soon as I get better. I'm sick currently.

Get well soon!

Yes, get well soon!
Your health comes first.

were can i find the manual install guide for mthis mod please

There is none at the moment I'm afraid. You can se this:
http://modparser.dev.dansoftaustralia.net/

To see the edits you need to do, though. It might help.
Let me know if you need help whit it.

will this work on smf 1.1.7

The mod? Yes, it will. Just use this package:
http://www.simplemachines.org/community/index.php?action=dlattach;topic=270529.0;attach=80401
The parser in my above post? Yes, it should if you choose version 1.1.3 in the selectbox.

ok thanks. its just the parser does not have 1.1.7 it only goes to 1.1.3

Tell it to use 1.1.3. It will work.

hey its installed ok but when i goto help pages in admin i get this error


"Parse error: syntax error, unexpected T_IF in /home/a5512024/public_html/Sources/HelpSettings.php on line 1"

any help mate

Please attach Sources/HelpSettings.php :)

will do. its also on search as well. you want that attatched aswell

both files are attatched for you. the search one is saying

"Parse error: syntax error, unexpected T_STRING, expecting ')' in /home/a5512024/public_html/Sources/Search.php on line 1682"

any news yet Nas

Be patient, he's busy and currently On Hiatus. Try to allow at least 24 hours before bumping your requests.

ok sorry about that. what is this simple portal like. is it any good

This mod does not affect Search.php, but I had a look at it and fixed it anyway.
About HelpSettings.php, your file was almost totally empty. I don't know what happend, but I'm attaching a fresh copy of it.

its still coming up with this error Nas "Parse error: syntax error, unexpected T_IF in /home/a5512024/public_html/Sources/HelpSettings.php on line 1".

Let me see Admin.php too please.

do you want me to attatch both helpsettings.php and admin.php or just admin.php

Admin.php

here you go Nas. hope you can get to the bottom of it

any news on the problem yet nas

I'm not sure on this. Did you replace your HelpSettings.php whit the one I attached in my above post?

i did mate. do you want me to check the permissions as i used java upload that my server company uses

You might want to use a regular way of uploading, as the javaupload maybe not replace files.

mate you deserve every single iota of credit that you get from people. i uploaded it useing WSftp and its working great. your an absolute star

Thank you :)

A little update on the progess of this.
I'm currently exploring other parts of SMF where similar things as the ones I will do for ECHP is done. I'll try to start on it before the end of the month.

hi nas were is the link to the mod and the installation instructions

http://www.simplemachines.org/community/index.php?topic=270529.msg1769165#msg1769165
The packes are located at the bottom of that post.

Quote from: Nas on January 25, 2009, 11:39:45 AM
http://www.simplemachines.org/community/index.php?topic=270529.msg1769165#msg1769165
The packs are located at the bottom of that post.

no they aren't...

Hi Nas , any news about this great mod??

I see of dont have any update since diciembre 23, 2008 with a little small update.

I know of you have a lot of things to do and the real life come first , so dont worry Nas I know of your are doing your best.

If I can help you in something just sent me a PM ;)

Quote from: Fattredd on February 03, 2009, 08:42:12 PM

Quote from: Nas on January 25, 2009, 11:39:45 AM
http://www.simplemachines.org/community/index.php?topic=270529.msg1769165#msg1769165
The packs are located at the bottom of that post.

no they aren't...

They are. Under to images:

QuoteECHP 1.0 Beta 1 Build 0.8.1a (SMF 2.0 Beta 4).zip (11.04 KB - downloaded 5 times.)
* ECHP 1.0 Beta 1 Build 0.8.1a (SMF 1.1.x).zip (10.99 KB - downloaded 6 times.)
* ECHP 1.0 Beta 1 Build 0.8.1a (1.1.x and TinyPortal).zip (11.1 KB - downloaded 6 times.)

Quote from: NBG on February 03, 2009, 10:09:11 PM
Hi Nas , any news about this great mod??

I see of dont have any update since diciembre 23, 2008 with a little small update.

I know of you have a lot of things to do and the real life come first , so dont worry Nas I know of your are doing your best.

If I can help you in something just sent me a PM ;)

I've started a bit om Beta 2. I've made it use less functions in the template file and will soon mae it use the database. Then I will rewrite the administrationsection and then finish of the looks of the help page.

any ideas when the SMF 2.0 RC1 version will be out

Oh. I thought I had released that already. Fixing it today.

well you did realese ECHP 1.0 Beta 1 Build 0.8.1a (SMF 2.0 Beta 4).zip but that doesnt seem to work on SMF 2.0 RC1

Releasing it shortly.

cool mate i wanna get rid of the SMF help files and add my own. keep me informed matey

1.0 Beta 1 Build 0.8.2a released
There is no new features or fixes in this version.
The only update is that the mod now supports SMF 2.0 RC1.
The SMF 2.0 Beta 4 version vas removed, as every forum should upgrade to RC1 now.

right matey its installed on all themes on 2.0 rc1 and is working 100%. thanks you mate

No problem. Let me here of any future problems.
Also, keep your eyes open. There will be a lot of updates to this before I submit it as a final mod to the mod site.

Well if you want me to be an additional tester for you just let me know and i'll set a test forum up with no mods at all and test what ever updates you make

That'd be good for Beta 2 (Should come in February. MOST come in Mars)

no probs mate. keep it up

Hey guys.

Sorry for the delay on this mod.
I just wanted you all to know that I'm now developing this mod again, and the process of ECHP 1.0 Beta 2 is going forward.
I've finished the basic functionallity, and left to code is the administrationpanel.
And hey, everything is finally databasedriven!

Attached is an early screenshot of Beta 2.
Note that I havent made the blocks yet, and the menu is going to be moved to the left again.

Nas, dude!

Do you have news about this mod?

Farewell

Quote from: Costa on July 16, 2009, 09:45:55 PM
Nas, dude!

Do you have news about this mod?

Farewell

Ditto.  ;D

We know that this kind of work takes time and you should take whatever time is required Nas, but it has been a while since your last comments about Beta 2... so we're just wondering about the status.  O:)

Sorry for the lack of updates. I've been working on several other projects such as my file manager latly. I will let you know of all updates.

Thanks Nas.  :D

Thank you Nas, only waiting for one update to translate :)