Our FamilyForum

FamilyForum Documentation & Help => FamilyForum Features & Guidelines => Code & Stuff => Topic started by: Ken on October 30, 2015, 08:07:53 AM

Title: TP Docs Rebuild/Update
Post by: Ken on October 30, 2015, 08:07:53 AM
Currently, along with Mick and Illori, I'm helping out with a major overhaul of the TinyPortal Documentation (http://www.tinyportal.net/docs/index.php).
We're making good progress, but we still have a very long way to go as we work our way through the many(100's?) pages of the Docs, so if you've looked at and used the TinyPortal Docs site please feel free to offer your input.  :thumbup:

Post you comments here and I'll bring them up in our Docs rebuild topic over on TP.

Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 30, 2015, 09:13:20 AM
Okie, dokie, Smokey...
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 30, 2015, 09:18:51 AM
Okie, dokie, Smokey...
laughing7
Title: Re: TP Docs Rebuild/Update
Post by: Maxx on October 30, 2015, 09:27:09 AM
Ken. Good deal Bro and thank you guys and thank you for the update , hard work as well:)

regards,
Maxx
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 30, 2015, 09:30:55 AM
You're welcome Maxx.  :thumbup:
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 30, 2015, 09:41:05 AM
I see a number of things already. LOL

Quote
Welcome to our Documentation and FAQ for TinyPortal

Ready to install TinyPortal and need some direction? Here you can find our Docs and a number of other boards and topics to help you work through any issues that you might face. Of course, you can always post to the Support Boards to ask any questions that you have. Please be sure to read our Posting Guidelines.

Maybe links for "Support Boards" and "Posting Guidelines"...for starters.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 30, 2015, 11:24:17 AM
I see a number of things already. LOL

Quote
Welcome to our Documentation and FAQ for TinyPortal

Ready to install TinyPortal and need some direction? Here you can find our Docs and a number of other boards and topics to help you work through any issues that you might face. Of course, you can always post to the Support Boards to ask any questions that you have. Please be sure to read our Posting Guidelines.

Maybe links for "Support Boards" and "Posting Guidelines"...for starters.

Good catch Steve... fixed it.  :hah!:
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 30, 2015, 11:25:20 AM
More coming...
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 30, 2015, 12:14:00 PM
Changes are in red...

Quote
What is a portal and how can I use it for my forum?
What is TinyPortal?

TinyPortal is a mod for Simple Machines Forum (SMF) that adds a powerful and mature Portal to your SMF Forum in minutes, with native integration, without having to worry about bridging, database, and appearance. Your SMF and TP will be a homogeneous ensemble from installation. It's up to you and your creativity to use TP's features to customize your site and organize its content.

Features included in TinyPortal:

Article System:
The article system gives you a CMS system tightly integrated with your forum. No need for bridges, double registering or other kludgey interface schemes with complex CMS software. Write articles in PHP, HTML or BBcode, also External articles and Cat List(category) and choose what membergroups can access them, who can contribute, and how they are approved. Whether you choose the built-in menu options for these pages or write your own, the flexibility to accommodate your choices is built-in.

Blocks:
Blocks is a term for the rectangles of information you can use throughout the portal. For the sake of simplicity, the page has been divided into the "panels", which when combined can mimic many common page layouts. These blocks can contain regular HTML, PHP code or special written functions that collect specific types of information. You can show them according to which permissions the visitor has, and even show them just in certain forum sections. You will come to love playing with them.

Some block types that are currently available:

    ShoutBox - Its a box in which you can leave messages for others to see and thus maintain a simple "chat" on the site. Combined with permissions, you will have much freedom in who can participate as well. And as your visitors will discover, its actually quite fun to leave a smiley or two in it.
    Recent Posts - Showing the recent posts in a small sidebar, and letting members know what is new and unread, encourages participation and will boost member satisfaction.
    Theme switcher - Let members and visitors choose their favorite theme.
    Search - Allows members to search your site for content.
    Other blocks include: Calendar, Poll, RSS feeds, Menu (Managed in the menu manager), User Profile block, and News. And since you can use PHP, HTML and BBC, the only limit is your imagination.


Menu Manager:
A built-in Menu Manager allows you to create multiple menu's. These menu's are displayed in a block. You get all the features of blocks to display these menu's in different places along with choosing who gets to see the blocks based on permissions. You can create different types of links: links to articles, categories, or even just a custom link. You can choose to have the link open in the current window or a new window.
When you view the Home page of this TinyPortal Docs site you are seeing the Menu Manager in action, all of the content in the blocks of information there was built using the Menu Manager system.

Downloads Manager:
A built-in module for TP that lets you offer files for your members to browse and download. Its works by having the downloadable files placed in categories. These categories have permissions on them, letting you restrict member groups access level per each category. You may also allow members to upload files, controlling which member groups are allowed and what types of files they may upload.

Hmmm, doesn't anything about what "panels" are...
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 30, 2015, 12:38:36 PM
Those changes look good... I'll work them in later today, or early in the AM.

On the panels thing, I'll take a look at including something, we already have blurbs about that topic elsewhere, but it would work here as well.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 30, 2015, 12:47:29 PM
Of course they look good!  :hah!:

More coming...but time to eat and take a nap.  :2cool!!
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 30, 2015, 08:16:37 PM
Changes are in red...

Quote
What is a portal and how can I use it for my forum?
What is TinyPortal?

TinyPortal is a mod for Simple Machines Forum (SMF) that adds a powerful and mature Portal to your SMF Forum in minutes, with native integration, without having to worry about bridging, database, and appearance. Your SMF and TP will be a homogeneous ensemble from installation. It's up to you and your creativity to use TP's features to customize your site and organize its content.

Features included in TinyPortal:

Article System:
The article system gives you a CMS system tightly integrated with your forum. No need for bridges, double registering or other kludgey interface schemes with complex CMS software. Write articles in PHP, HTML or BBcode, also External articles and Cat List(category) and choose what membergroups can access them, who can contribute, and how they are approved. Whether you choose the built-in menu options for these pages or write your own, the flexibility to accommodate your choices is built-in.

Blocks:
Blocks is a term for the rectangles of information you can use throughout the portal. For the sake of simplicity, the page has been divided into the "panels", which when combined can mimic many common page layouts. These blocks can contain regular HTML, PHP code or special written functions that collect specific types of information. You can show them according to which permissions the visitor has, and even show them just in certain forum sections. You will come to love playing with them.

Some block types that are currently available:

    ShoutBox - Its a box in which you can leave messages for others to see and thus maintain a simple "chat" on the site. Combined with permissions, you will have much freedom in who can participate as well. And as your visitors will discover, its actually quite fun to leave a smiley or two in it.
    Recent Posts - Showing the recent posts in a small sidebar, and letting members know what is new and unread, encourages participation and will boost member satisfaction.
    Theme switcher - Let members and visitors choose their favorite theme.
    Search - Allows members to search your site for content.
    Other blocks include: Calendar, Poll, RSS feeds, Menu (Managed in the menu manager), User Profile block, and News. And since you can use PHP, HTML and BBC, the only limit is your imagination.


Menu Manager:
A built-in Menu Manager allows you to create multiple menu's. These menu's are displayed in a block. You get all the features of blocks to display these menu's in different places along with choosing who gets to see the blocks based on permissions. You can create different types of links: links to articles, categories, or even just a custom link. You can choose to have the link open in the current window or a new window.
When you view the Home page of this TinyPortal Docs site you are seeing the Menu Manager in action, all of the content in the blocks of information there was built using the Menu Manager system.

Downloads Manager:
A built-in module for TP that lets you offer files for your members to browse and download. Its works by having the downloadable files placed in categories. These categories have permissions on them, letting you restrict member groups access level per each category. You may also allow members to upload files, controlling which member groups are allowed and what types of files they may upload.

Hmmm, doesn't anything about what "panels" are...

Done.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 12:13:57 AM
1.  On the main page, the "Articles" and "Frontpage" section are different heights. "Articles" have 4 items in it and is shorter than "Frontpage" which has only 3 items in it???

(https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fdocskillz.com%2Fdocs%2Fimages%2Fdocsmainpage.png&hash=6e09fe0d7e87a5a61d3ea93082707981981af590)

2.  On that same page, some of the links have all large capital letters while others do not.

3.  In the image below, I think it should be: How To "Create" A...

(https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fdocskillz.com%2Fdocs%2Fimages%2Fhowtocreate.png&hash=4b43ec84bd1ef71a0b0cf7933967279e3635ff81)

The [ and ] brackets seem to imply coding.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 01:28:48 AM
Quote
How Do I Install Tiny Portal?  First and most importantly, make a backup of your forum. If you are not sure how to do that, you can this the guide: How Do I Create A Backup Of My Site? (http://docs.simplemachines.org/index.php?topic=492.0)

Second, download the version of Tiny Portal you wish to use (latest release recommended) from: http://www.tinyportal.net/index.php?action=tpmod;dl=tinyportal (http://www.tinyportal.net/index.php?action=tpmod;dl=tinyportal)

Third, in your SMF forum go to "Admin > Package Manager > Download Packages > Package to Upload > Browse" then select the TP package you downloaded and click "Upload".

Forth, once the TinyPortal package has been successfully uploaded click on the "Install Mod" link.

Finally, assuming everything tested successfully, with no red "Test failed" warnings showing, click on the "Install Now" link and your all done!

*However, if it shows "Test failed", you may need to manually install Tiny Portal. You can read instructions on how to do that here: How Do I Manually Install Tiny Portal? (http://custom.simplemachines.org/mods/index.php?action=parse;mod=97;attach=244443;smf_version=2.0.11)

If you are experienced and confident with what you are doing, you can proceed to install even though it says "Test failed", and manually modify those files using the guidelines from the manual install guide mentioned previously.

Useful Links:
Package manager (http://wiki.simplemachines.org/smf/SMF2.0:Package_manager) ...A Doc on the SMF Package Manager and file permissions.

The one thing that I notice the most is a lack of consistency in coloring, spelling, grammar as far as what things are called. Things like "member groups" that are in the docs should as SMF calls them to make sure NEW users do not think it is something different. SMF calls it "membergroups" without the space. That is what they may be looking for, specifically. When they see something different they may think it is referring to something else.

And you can never overstate details! Remember, some people will be trying to build a website while they barely know how to use a computer. Been there dozens or hundreds of times. They are missing steps because of a lack of basic computer knowledge that we take for granted. They may have seen an ad for "making millions running a website" or something else to make money with their computer. Meanwhile, they have not taken the time to learn the basics of working a PC or surfing the internet.

That is how I run my site...based on that they may not know these things. Giving them too much information they may already know will save a lot of time instead of asking question after question and a week later you realize they know nothing about using a computer and are trying to run a website. My tutorials give a kind of "you are here and next you want to go there" through the displaying of images. This also has the advantage of helping people who do not speak English as the images will help show them what they wish to accomplish and will also help everyone (no matter what language they speak) make sure they know where they should be and what they should be doing.

This also has an added benefit of dramatically cutting back on support which will leave the staff more time for other things...like working on newer TP versions.  :thumbup:
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 31, 2015, 07:25:52 AM
Quote
How Do I Install Tiny Portal?  First and most importantly, make a backup of your forum. If you are not sure how to do that, you can this the guide: How Do I Create A Backup Of My Site? (http://docs.simplemachines.org/index.php?topic=492.0)

Second, download the version of Tiny Portal you wish to use (latest release recommended) from: http://www.tinyportal.net/index.php?action=tpmod;dl=tinyportal (http://www.tinyportal.net/index.php?action=tpmod;dl=tinyportal)

Third, in your SMF forum go to "Admin > Package Manager > Download Packages > Package to Upload > Browse" then select the TP package you downloaded and click "Upload".

Forth, once the TinyPortal package has been successfully uploaded click on the "Install Mod" link.

Finally, assuming everything tested successfully, with no red "Test failed" warnings showing, click on the "Install Now" link and your all done!

*However, if it shows "Test failed", you may need to manually install Tiny Portal. You can read instructions on how to do that here: How Do I Manually Install Tiny Portal? (http://custom.simplemachines.org/mods/index.php?action=parse;mod=97;attach=244443;smf_version=2.0.11)

If you are experienced and confident with what you are doing, you can proceed to install even though it says "Test failed", and manually modify those files using the guidelines from the manual install guide mentioned previously.

Useful Links:
Package manager (http://wiki.simplemachines.org/smf/SMF2.0:Package_manager) ...A Doc on the SMF Package Manager and file permissions.

The one thing that I notice the most is a lack of consistency in coloring, spelling, grammar as far as what things are called. Things like "member groups" that are in the docs should as SMF calls them to make sure NEW users do not think it is something different. SMF calls it "membergroups" without the space. That is what they may be looking for, specifically. When they see something different they may think it is referring to something else.

And you can never overstate details! Remember, some people will be trying to build a website while they barely know how to use a computer. Been there dozens or hundreds of times. They are missing steps because of a lack of basic computer knowledge that we take for granted. They may have seen an ad for "making millions running a website" or something else to make money with their computer. Meanwhile, they have not taken the time to learn the basics of working a PC or surfing the internet.

That is how I run my site...based on that they may not know these things. Giving them too much information they may already know will save a lot of time instead of asking question after question and a week later you realize they know nothing about using a computer and are trying to run a website. My tutorials give a kind of "you are here and next you want to go there" through the displaying of images. This also has the advantage of helping people who do not speak English as the images will help show them what they wish to accomplish and will also help everyone (no matter what language they speak) make sure they know where they should be and what they should be doing.

This also has an added benefit of dramatically cutting back on support which will leave the staff more time for other things...like working on newer TP versions.  :thumbup:

Done!  :2cool!!

Thank you for the input Steve... I actually subscribe to everything you are saying and try to reach for that level of detail and correctness. Having someone who is willing to proofread my work is a good thing however, as you have discovered.  laughing7
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 09:16:31 AM
Maybe it's just me but...this part of "How Do I Add A Block To An Article (http://www.tinyportal.net/docs/index.php?topic=65)?" makes no sense. Try to follow along with it:

Quote
Assuming that you have already created your block, go to: "Admin > Tiny Portal > Panels & Blocks > SELECT PANEL AREA > Blocks" and edit the block you wish to add to an article. In the Block settings, look for "Show when viewing this article" option, and select the article you wish for it to appear in from the droplist.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 31, 2015, 10:02:28 AM
There are a great many topics that I'll be re-writing as the process goes along including adding images to some of them to try to give the person viewing the doc a better understanding of the message being presented.
Like this one for example:
http://www.tinyportal.net/docs/index.php?page=11
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 10:15:39 AM
Looks good! But the other one makes no sense to me. I know you can add panels or certain block alongside of articles but I can't even find what that part is talking about.

Maybe it was supposed to be how to add an article to a block? Cause I'm not sure how to fix it. LOL
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 31, 2015, 10:23:51 AM
Basically it's supposed to be telling you how to show your block in an article. If you look in the lower right of the block settings screen you'll see a listing of your available articles and if you :tick: an article then that block will show for that article.
Me gotta fix the attachments!   :censored:

(https://www.ourfamilyforum.org/gallery0/64-311015102526.png)
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 10:27:58 AM
You mean like left or right panel blocks? Not individual blocks? The Doc seems to imply specific blocks.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 31, 2015, 10:52:25 AM
It is specific blocks... for each block that you want to display in an article you must do that :tick: in the block's settings panel for that article and block match up.

For example, if you want your shoutbox to show in an article, then you must make that :tick: ... then the shoutbox will show in the article and in whatever panel you have your SB parked in. So here on OFF the shoutbox would then show in the left panel of the article.
One thing that needs to be added to this docs is the part about needing to :tick: for the panel you want to show, it the example below it's " Display leftblocks"
Here's an example:
www.ourfamilyforum.org/FamilyForum/index.php?page=110
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 11:04:56 AM
LOL! I didn't know it could do that.

My next question is what the hell is a :tick: ??? I assume it is a smiley that is not working???
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 31, 2015, 12:08:18 PM
Code: [Select]
:tick: = 'check mark'
(https://www.ourfamilyforum.org/gallery0/64-311015120148.png)

Or, maybe like this... :tick:
I've been using this 'tick' on the docs site, just added it to the Smiley set here as well.  laughing7
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 31, 2015, 04:57:48 PM
1.  On the main page, the "Articles" and "Frontpage" section are different heights. "Articles" have 4 items in it and is shorter than "Frontpage" which has only 3 items in it???

(https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fdocskillz.com%2Fdocs%2Fimages%2Fdocsmainpage.png&hash=6e09fe0d7e87a5a61d3ea93082707981981af590)

2.  On that same page, some of the links have all large capital letters while others do not.

3.  In the image below, I think it should be: How To "Create" A...

(https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fdocskillz.com%2Fdocs%2Fimages%2Fhowtocreate.png&hash=4b43ec84bd1ef71a0b0cf7933967279e3635ff81)

The [ and ] brackets seem to imply coding.

Fixed. :tick:
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 05:09:49 PM
Ah! If you would have said "check" I would have got it. LOL
Title: Re: TP Docs Rebuild/Update
Post by: Ken on October 31, 2015, 09:30:07 PM

Hmmm, doesn't anything about what "panels" are...

It do now.
www.tinyportal.net/docs/index.php?topic=150
Gonna write a more in depth topic about this later.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on October 31, 2015, 09:40:03 PM
Good deal!
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 03, 2015, 07:26:21 AM
Got a long list for this one.  :hidden:



Articles (http://www.tinyportal.net/docs/index.php?board=26)

A Beginners Guide to the TinyPortal Article Management System.  (https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fwww.tinyportal.net%2Fdocs%2FSmileys%2Fdefault%2Ftick.gif&hash=4d790fb12c5df3a6005b473a365b2a89cfe5f921)

What Are The Article Settings? (https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fwww.tinyportal.net%2Fdocs%2FSmileys%2Fdefault%2Ftick.gif&hash=4d790fb12c5df3a6005b473a365b2a89cfe5f921)
      
What Are Article Icons?
      
What Are The Article Category Settings?
      
Who Can Submit Articles?
      
What Are Article Categories?
   
How Do I Port My Old HTML Page Content To An Article?

How Do I Sort My Articles?

How Do I Print An Article?
   
How Do I Add A Block To An Article?
      
How Do I Sticky An Article?
      
How Do I Lock An Article?
      
How Do I Adjust My Article's Visual Options?

How Do I Create An Article?
      
How Do I Manage My Articles?
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 12:07:34 AM
1.  How Do I Embed A Internal/External Webpage? (http://www.tinyportal.net/docs/index.php?topic=56)

That link needs a login...

2.  Read more about Articles HERE (http://www.tinyportal.net/docs/index.php?board=26) - leads to this page:

http://www.tinyportal.net/docs/index.php?board=26 - title should say Article Setup & Management...at first glance one may think they are on the page for Tinyportal General Setup and Management and may click away from that page.

3.  What Are The Article Settings? (http://www.tinyportal.net/docs/index.php?topic=96)

Use the WYSIWYG editor?:
Missing "Yes" option. All other settings have a "Yes" option.4.  Missing images for these 2:
Hide the edit article link under articles?
Show print icon in articles?
5.  Maybe add the "E" edit icon to this image at the end of "Hide the edit article link under articles?"...like the print option does:(https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fwww.tinyportal.net%2Fdocs%2Fgallery%2F2_03_11_15_9_44_26.png&hash=e7b676f132e7298fdfcf2cd127a409c79d118770)
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 05:27:53 AM
I was just looking at this and wondering:

http://www.tinyportal.net/docs/index.php?topic=58

Why does TP have "uncategorized" and "not assigned"? Don't they mean the same thing? Personally, I think it should be "uncategorized" but it could also be "unassigned".
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 05:33:42 AM
Working on it. :)


For this part, sounds right... you should post it to  the beta topic over on TP.  :thumbup:
I was just looking at this and wondering:

http://www.tinyportal.net/docs/index.php?topic=58

Why does TP have "uncategorized" and "not assigned"? Don't they mean the same thing? Personally, I think it should be "uncategorized" but it could also be "unassigned".
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 05:38:02 AM
I figured I'd run it by you first and see what you thought...just in case they both actually meant different things that I was unaware of. LOL
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 06:02:57 AM
1.  How Do I Port My Old HTML Page Content To An Article? (http://www.tinyportal.net/docs/index.php?topic=57)

Then on your old webpage, highlight all of your HTML code between your <body> & </body> tags and copy it by right-clicking and selecting "copy", or press "CTRL C".

Now you will want to place that code into your new article. In your article right-click and select "paste". If the editor is enabled, it may not let you. You will need to press "CTRL V" to paste the code into the article. PLEASE MAKE SURE YOU DO NOT ADD THE HTML <body> & </body> TAGS IN YOUR ARTICLE! This may result in a blank page or the article not showing correctly.

* Ken, notice the " - " between "right-clicking" and "right-click".

2.  How Do I Sort My Articles? (http://www.tinyportal.net/docs/index.php?topic=55)

To sort your articles you can go:
TP Admin > Articles > Articles in a category > (select the category with the articles you wish to sort)
This part in red "Articles in a category >" implies there is a setting with that name...but there is none. A better way would be:

To sort your articles you can go to:
TP Admin > Articles > Select the category with the articles you wish to sort and you will then see a list of your articles within that category.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 06:52:13 AM
1/ done.
http://www.tinyportal.net/docs/index.php?topic=57

2/ done.
http://www.tinyportal.net/docs/index.php?topic=55.0
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 06:53:23 AM
How Do I Print An Article? (http://www.tinyportal.net/docs/index.php?topic=54)

To print an article, just click Print Icon when viewing an article.

However, there is no icon anymore! Check here...I just did and on my sites. It just says "Print".
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 07:01:45 AM
1.  How Do I Embed A Internal/External Webpage? (http://www.tinyportal.net/docs/index.php?topic=56)

That link needs a login...

2.  Read more about Articles HERE (http://www.tinyportal.net/docs/index.php?board=26) - leads to this page:

http://www.tinyportal.net/docs/index.php?board=26 - title should say Article Setup & Management...at first glance one may think they are on the page for Tinyportal General Setup and Management and may click away from that page.

3.  What Are The Article Settings? (http://www.tinyportal.net/docs/index.php?topic=96)

Use the WYSIWYG editor?:
  • No | This option will disable any WYSIWYG editor from being used in HTML/BBC articles. - Missing the word "editor".
Missing "Yes" option. All other settings have a "Yes" option.
  • Yes | This option will enable the WYSIWYG editor to be used in HTML/BBC articles.
4.  Missing images for these 2:
Hide the edit article link under articles?
  • Yes | This option will hide the quick "edit" link for those with permission at the top the article.
  • No | This option will show the quick "edit" link for those with permission to edit the article.
Show print icon in articles?
  • Yes | This option will show the icon, allowing user's to print just the content of the article.
  • No | This option will not show the icon, not allowing user's to print just the content of the article.
5.  Maybe add the "E" edit icon to this image at the end of "Hide the edit article link under articles?"...like the print option does:(https://www.ourfamilyforum.org/FamilyForum/proxy.php?request=http%3A%2F%2Fwww.tinyportal.net%2Fdocs%2Fgallery%2F2_03_11_15_9_44_26.png&hash=e7b676f132e7298fdfcf2cd127a409c79d118770)

1/... where do you find that link Steve? It should not be visible, except to admins.
2/ done.
3/ done.
4/ I'll get back to this one later.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 07:10:04 AM
1.  It is on the main Docs page in the "Articles" section under "Getting Started".

4.  And printing is turned on here and on my site.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 07:11:54 AM
How Do I Print An Article? (http://www.tinyportal.net/docs/index.php?topic=54)

To print an article, just click Print Icon when viewing an article.

However, there is no icon anymore! Check here...I just did and on my sites. It just says "Print".

done
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 07:14:07 AM
How Do I Lock An Article? (http://www.tinyportal.net/docs/index.php?topic=51)

To lock an article to keep anyone from commenting on the article, just go to: "TP Admin > Articles > Select The Article You Wish To Lock > Status" Click The Lock Icon(Lock this article for editing)

Should be:

To lock an article to keep anyone from editing the article, just go to: "TP Admin > Articles > Select The Article You Wish To Lock > Status" Click The Lock Icon(Lock this article for editing)

How Do I Print An Article? (http://www.tinyportal.net/docs/index.php?topic=54)

To print an article, just click Print Icon when viewing an article.

However, there is no icon anymore! Check here...I just did and on my sites. It just says "Print".

done

Should this be posted at TP to see if there should/will be an icon added?
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 07:21:46 AM
1.  It is on the main Docs page in the "Articles" section under "Getting Started".

4.  And printing is turned on here and on my site.

1/ link removed
2/ most of the docs(99%+) are actually forum topics, so there would not be a print link available... is that what you are talking about?

...example:
 [ Invalid Attachment ]
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 07:23:39 AM
"Should this be posted at TP to see if there should/will be an icon added?" ... yes, please do so. :D
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 07:27:06 AM
There used to be a print icon at one time...it was on the top right side in the title header. I remember it but didn't notice until recently that it was removed.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 07:29:31 AM
Quote
How Do I Lock An Article?

To lock an article to keep anyone from commenting on the article, just go to: "TP Admin > Articles > Select The Article You Wish To Lock > Status" Click The Lock Icon(Lock this article for editing)

Should be:

To lock an article to keep anyone from editing the article, just go to: "TP Admin > Articles > Select The Article You Wish To Lock > Status" Click The Lock Icon(Lock this article for editing)

Are you sure about this Steve? I thought it was for keeping members from commenting while you did edits.

Maybe it should be:
To lock an article to keep anyone from editing the article at the same time as you do, just go to: "TP Admin > Articles > Select The Article You Wish To Lock > Status" Click The Lock Icon(Lock this article for editing)
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 07:42:57 AM
BTW... the screenshot in Reply #39 looks like this when viewed in the default theme.(ganymedesdcos2)
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 07:49:29 AM
Yup! Each article has a setting to disable commenting on it. I do think categories should also have the same option for all articles within that category.

Well, it locks the article no matter what is going on until you unlock it. There may be other admins, etc. that you do not want editing your articles and may wish to keep it locked permanently.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 07:58:19 AM
Quote
4.  Missing images for these 2:
Hide the edit article link under articles?

    Yes | This option will hide the quick "edit" link for those with permission at the top the article.
    No | This option will show the quick "edit" link for those with permission to edit the article.

Show print icon in articles?

    Yes | This option will show the icon, allowing user's to print just the content of the article.
    No | This option will not show the icon, not allowing user's to print just the content of the article.

5.  Maybe add the "E" edit icon to this image at the end of "Hide the edit article link under articles?"...like the print option does:

4/ check my fix there, do you like it better now?
5/ you should post that in the TP 2.0 beta topic... and maybe the TP 1.1 topic beta as well.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 08:01:42 AM
Yup! Each article has a setting to disable commenting on it. I do think categories should also have the same option for all articles within that category.

Well, it locks the article no matter what is going on until you unlock it. There may be other admins, etc. that you do not want editing your articles and may wish to keep it locked permanently.

We should test this out... me gotta be off here shortly, but later on I'll setup an article that's locked and then you can try to edit and comment to see exactly how this works.

Ps: I like the category setting idea.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 08:19:39 AM
Ok...
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 08:28:40 AM
OK, this article is locked... comments are turned on.
http://www.ourfamilyforum.org/FamilyForum/index.php?page=115
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 09:22:22 AM
Apparently, it lets admins edit it because I could edit it. Look at the very bottom and you'll see "Edit...". Change my membergroup and we can try it again.

But when I try to add a comment I get this:

Quote
An Error Has Occurred!
The letters you typed don't match the letters that were shown in the picture.

It appears that there is a missing verification image somehow and none is shown in the article anywhere.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 09:41:42 AM
1.  How Do I Adjust My Article's Visual Options? (http://www.tinyportal.net/docs/index.php?topic=50)

Quote
To adjust an articles visual options, such as showing left panel, right panel, author, date, etc. Go to: "Admin > Tiny Portal > Articles > Select The Article You Wish To Adjust > Edit Visual Options". You can also just select "edit visual options" at the bottom of any article, assuming you have permission to do such.

Should be:

Quote
To adjust an article's visual options, such as showing left panel, right panel, author, date, etc. Go to: "Admin > Tiny Portal > Articles > (Select The Article You Wish To Adjust) > Edit Visual Options". You can also just select "edit visual options" at the bottom of any article, assuming you have permission to do such.

2.  How Do I Manage My Articles? (http://www.tinyportal.net/docs/index.php?topic=48)

Quote
You can read more about category settings HERE (http://www.tinyportal.net/help/index.php?topic=92.0).

 ...the "HERE" link goes to a 404 page.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 10:32:07 AM
Under the "Frontpage" section on the main page...

1.  How to Create A Splash Page (http://www.tinyportal.net/docs/index.php?topic=47)

The link goes to a login page...

2.  How to Arrange Articles On The Frontpage (http://www.tinyportal.net/docs/index.php?topic=45)

After the first image...

Quote
There will be a "Pos"(position) box to the left of each article in the category and as seen in this picture the default value is '0' and that means that each article will be sorted by date. To change the order you can enter a numerical value into the box and by doing so move an article's position in the sort.

Should be:

Quote
There will be a "Pos"(position) box to the left of each article in the category and as seen in this picture. The default value is "0" and that means that each article will be sorted by date. To change the order you can enter a numerical value into the box and by doing so will move an article's position in the sort.

* Note - the "0" in the text above appears as a small "o" instead of a capital "O" or a "0" (zero).
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 07, 2015, 02:27:46 PM
Apparently, it lets admins edit it because I could edit it. Look at the very bottom and you'll see "Edit...". Change my membergroup and we can try it again.

But when I try to add a comment I get this:

Quote
An Error Has Occurred!
The letters you typed don't match the letters that were shown in the picture.

It appears that there is a missing verification image somehow and none is shown in the article anywhere.

OK, try it now.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 05:17:08 PM
Can't edit and at the bottom it says:

You don't have permmission to comment, or comments have been turned off for this article.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 07, 2015, 07:52:31 PM
How Do I Install A New Module? (http://www.tinyportal.net/docs/index.php?topic=97)

Quote
Top install a new module, you must first have your module selected and saved to hard drive or flash drive. Then simply go to: "Admin > TinyPortal > Modules > Uploaded Modules". Here you will see a list of already uploaded modules, and at the bottom an option to "browse" your hard drive or memory space to select the module you have, then click "save" to upload the module.

Should be:

Quote
To install a new module, you must first have your module selected and saved to hard drive or flash drive. Then simply go to: "Admin > TinyPortal > Modules > Uploaded Modules". Here you will see a list of already uploaded modules, and at the bottom an option to "browse" your hard drive or flash drive to select the module you have, then click "save" to upload the module.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 08, 2015, 06:13:48 AM
What Are The Module Settings? (http://www.tinyportal.net/docs/index.php?topic=98)

Quote
This is an excellent tool for troubleshoot, if you are having problems with a installed module.

Should be:

Quote
This is an excellent tool for troubleshooting, if you are having problems with a installed module.

How Do I Configure My Frontpage Settings? (http://www.tinyportal.net/docs/index.php?topic=40)

At the very bottom of the page:

Quote
Once you have finished with your frontpage settings, just click save and your done!

Should be:

Quote
Once you have finished with your frontpage settings, just click save and you're done!

How Do I Configure My Panel Settings? (http://www.tinyportal.net/docs/index.php?board=42)

Totally wrong link! It actually show this: How do I Manually Remove TP V1.0.* from my Site? (http://www.tinyportal.net/docs/index.php?topic=146)

And that link also needs a How to remove for TP 1.1.x...maybe just how to remove TP with the various versions within it.

How Do I Configure My TP Settings? (http://www.tinyportal.net/docs/index.php?board=39)'

Again, wrong link...goes to TP How-to's. May need to be rewritten. Personally, I think the entire Docs needs to be rewritten.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 08, 2015, 07:49:13 AM
"Again, wrong link...goes to TP How-to's. May need to be rewritten. Personally, I think the entire Docs needs to be rewritten."
Err... Umm... that's what I'm doing Steve!  shocked003

I'm trying to systematically go through the TP 1.0 Docs and copy them over into the TP 1.1 Docs and then making updates and rewrites as needed. For a while I was simply updating the 1.0's but soon realized that was not going to work because for one thing, the 1.0's needed to be preserved, but mostly because it would be confusing for a user to look at a doc that had 1.0 in the title when they were trying to get help on a 1.1 question.  As I get these tips and suggested edits from Illori, you and Mick, I have been applying them to go along with my own efforts.

For my update/rewrite procedure, it goes like this:
As mentioned elsewhere, on the Docs home page I go to the next block, in turn and begin to work on each link in that block's contents. Currently I'm working on the 'Blocks' block and under that category any and all topics get copied over from 1.0 to a newly created 'Blocks' board in the 1.1 category.
As I copy over each topic the content is edited as needed to work with 1.1 functions. As you may have noticed, I like to included an image or two because I think it makes the topic easier for a user to understand... we have lots of international users, so to me that's an even larger reason to include the occasional image.

BTW... I'm going to start entering your edits into the Docs bug tracker, should have done so from the beginning.

Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 08, 2015, 08:01:44 AM
LOL! What I mean is start fresh and with a new look (if you have not started doing so already) for v1.1 and v1.0. The blocks and titles that go under them are confusing and some need to be rearranged or just rewritten. Some of the titles I think should be in other blocks or have the titles renamed to suit the links beneath them, etc.

As far as your procedure goes, that is how I'm going about it...one block at a time with the links under it. I think a lot more images should be included. This will help cut back on support as well as help the international users. Hmmm, starting Project # 3092...  :rofl2
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 08, 2015, 08:03:16 AM
...and I think it should look more like whatever the current TP theme is...
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 08, 2015, 08:26:00 AM
Hmmm, starting Project # 3092...  :rofl2
groan:
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 08, 2015, 08:34:18 AM
LOL! What I mean is start fresh and with a new look (if you have not started doing so already) for v1.1 and v1.0.

...and I think it should look more like whatever the current TP theme is...

We would need to give that some thought because the current docs site theme was built by Bloc so that it would display the docs more like an html page than like a forum. And that's what it actually is... a forum, with boards and topics and a few TP articles.

If we did change it, then we would have to accept that it would look like a forum instead of the current look and style, because this theme is a one of a kind.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 08, 2015, 08:43:12 AM
It doesn't have to look like a forum. Remember, TP can create HTML pages and make a site NOT look like a forum. You can even remove or change the main menu so it matches the look of a doc site. Another idea is to go with different software specifically for such a thing but that would defeat the purpose of what TP can do. Using TP would show off what can be done with it.

I was thinking of maybe keeping the same format but changing the titlebg's using the Tinyportal's titlebg's/catbg's from the current theme. That would be pretty easy to do. And can change the formatting of the blocks, maybe.

EDIT: Remember the Docs site is a totally different site with its own logins...
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 08, 2015, 09:23:10 AM
What if we made a duplicate test site and played with that to see what we come up with?

Backup the Docs site and put it on one of our sites to play with. I have tons of room on my server if you don't have enough on yours. I'm currently using 1.6 GB of 15GB total space...with about 12 sites on it for about $10/month.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 08, 2015, 09:41:09 AM
Going with a different software would be a major thing! We should stick with TP imo because that's what we are promoting.
Going with TP articles would work and that was my first thought as we started this, but the forum/boards/topics were already in place so that's how we went.

We might want think about using BBC articles though, that way copying 1.0 topics would work because of the BBC formatting already in use in them. Of course HTML would work and that's what I use most.

 
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 08, 2015, 09:45:28 AM
Works for me!
Title: Re: TP Docs Rebuild/Update
Post by: Mick on November 09, 2015, 03:35:31 PM
Going with a different software would be a major thing! We should stick with TP imo because that's what we are promoting.
Going with TP articles would work and that was my first thought as we started this, but the forum/boards/topics were already in place so that's how we went.

We might want think about using BBC articles though, that way copying 1.0 topics would work because of the BBC formatting already in use in them. Of course HTML would work and that's what I use most.

We discussed this a while back about using a different software, and Ken you know how I feel about that.  Like I said back then, we build a portal system for doing this kind of thing, and it would be a letdown to have to use something else just to display pages of information. If we can get it looking good in TP then it's a great advert for TP. IMO. ;)
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 09, 2015, 06:35:17 PM
Going with a different software would be a major thing! We should stick with TP imo because that's what we are promoting.
Going with TP articles would work and that was my first thought as we started this, but the forum/boards/topics were already in place so that's how we went.

We might want think about using BBC articles though, that way copying 1.0 topics would work because of the BBC formatting already in use in them. Of course HTML would work and that's what I use most.

We discussed this a while back about using a different software, and Ken you know how I feel about that.  Like I said back then, we build a portal system for doing this kind of thing, and it would be a letdown to have to use something else just to display pages of information. If we can get it looking good in TP then it's a great advert for TP. IMO. ;)

Oh, I agree with that Mick.
As we have all stated in one way or another... "We are promoting TinyPortal, so we should use TP to build this." Meaning using articles and blocks and menu's etc, instead of using outside programs to build our support site or the docs site.

Of late we've drifted a little in our euphoria over finally getting some stuff fixed/completed/changed, but now it's time to get back on track and start to do more fixing than changing/removing.  :azn:
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 10, 2015, 09:43:55 AM
The only thing would be the bug tracker...is that updated regularly?
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 10, 2015, 11:13:31 AM
The last 'official' update for Project Tools was, June 26, 2011.
There was an update of sorts in June, 2011, as seen HERE (http://www.simplemachines.org/community/index.php?topic=273062.msg3064890#msg3064890). It's really old and out of date and it's safe to say that it's going to stay that way.

I've given some thought to how a bug tracker could be made using some of the features in TP, but I don't see how that could be made to work as needed... same with SMF. There just is not a good alternative that I can see, so at this point we seem to be stuck with Project Tools.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 13, 2015, 07:19:37 PM
Ken, remember our discussion on "How do I put a block in an article? (http://www.tinyportal.net/docs/index.php?topic=199)"? To clarify, is that supposed to mean that you can put a block within an article? Because that is what it seems to imply but this does not seem to work for me on my test site. Just trying to figure out if my concept of this is wrong or it is just not working as it should.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 14, 2015, 05:15:34 AM
Ken, remember our discussion on "How do I put a block in an article? (http://www.tinyportal.net/docs/index.php?topic=199)"? To clarify, is that supposed to mean that you can put a block within an article? Because that is what it seems to imply but this does not seem to work for me on my test site. Just trying to figure out if my concept of this is wrong or it is just not working as it should.
The perception is incorrect. We need to reword the doc so that it indicates that you can cause a block to show along the side/top/bottom of an article in the same way that it would anywhere else you have a block set to show... as seen HERE. (http://www.ourfamilyforum.org/FamilyForum/index.php?page=115)

Here are the panel settings to show a block(s) in(beside) an article, these settings are found in the lower part of the page when you are editing an article.
 [ Invalid Attachment ]

In order for it to work your block must be turned on, it must have the article selected in it's "Choose where the block should appear." options, the panel where it resides must be turned on and then the panel must be selected in the article.

Don't know why I've not picked up on that before, but I'm glad that you did.  :thumbup:

Ps: I've been copying over the docs from TP 1.0 to TP 1.1 and while some are updated and proof read, I think that we will need to go through them all again at some point.
But... my thinking is that we should get all of the copying over completed and then start with the complete top to bottom review of just the 1.1 docs. For now my only focus will be to get the 1.0's ported over to the 1.1's.

What are your thoughts?
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 14, 2015, 05:54:49 AM
I picked up on it because of an idea I had. I was thinking of redesigning the docs site. Looking at it, it appears that it is completely designed with TP blocks which is not true. Bloc used mootools (javascript) for the design of the blocks and another js script for the menus...I forget the name. But you can press F12 and select any section to see what I'm talking about.

Back to the redesign of the site... Since it looks like a collection of blocks it would be great if we can do that with TP...especially within an article! This is why I've been asking about this. It would be so much easier to design any site using any blocks that you can create with TP! It would also blow the competition out of the water!!!  shocked003

I'm sure illori is not up to the task but am wondering if Sayaka is... We just can't keep using these old scripts and themes when we know they will not be updated! We're just spinning our wheels in the mud and will be redoing the same work over and over when the time could be spend on other things like support. Right now there is not much support and this is the time when we should be looking at alternatives and getting things done while we can and are not busy with support like TP used to be.

Back to redesigning the Docs site... Since it would be easier to use HTML and/or PHP (HTML would be a lot easier), I was looking at HTML programs that allow you to immediately see how your design would look WHILE you are working on it. Most of those have an editor that you can drop n drag images, etc. making it very easy without a lot of coding knowledge. So far, I've narrowed it down to this...unless you guys know of something better and easier to use...

http://www.virtualmechanics.com/products/dwarf/

Also, the forum design is way too confusing and not user-friendly. We are all used to the way SMF was originally designed and can get things done much quicker that way. So, I was thinking maybe a hidden link to the forum or only if you are registered?

Does any of this make sense?
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 14, 2015, 06:35:17 AM
For the 'blocks in an article' part:
I don't know about the coding part, but we already do something a little like that with the menu function, so maybe it's not such a big leap to do what you're suggesting. If you look at the docs home page, all those blocks are actually just one big html block with lots of menu blocks inside... look here (http://www.tinyportal.net/docs/index.php?action=tpadmin;sa=menubox;mid=19).

Downloaded the program, gonna give it a try.

As for the look/theme of the docs site... I'm close to thinking that you are right about dropping the current theme and using the same one as TP and letting it look like an SMF/TP forum. Not so sure on the letting them register though, but if we do that extra care must be taken so that they are not able to post/reply/comment.

We would need to run any changes by Mick of course.

Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 14, 2015, 06:37:28 AM
BTW... I'm planing on writing an article/topic about menu's for the next "Feature of the Month" posting.  laughing7
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 14, 2015, 07:02:18 AM
For the 'blocks in an article' part:
I don't know about the coding part, but we already do something a little like that with the menu function, so maybe it's not such a big leap to do what you're suggesting. If you look at the docs home page, all those blocks are actually just one big html block with lots of menu blocks inside... look here (http://www.tinyportal.net/docs/index.php?action=tpadmin;sa=menubox;mid=19).

If you look closer you'll see a lot of javasrcipt being used...press F12, mootools are being used for the blocks and another js script is used for the menus.

http://ajax.googleapis.com/ajax/libs/mootools/1.2.1/mootools-yui-compressed.js

http://www.tinyportal.net/docs/Themes/tp_docs_theme/js/MenuMatic_0.68.3.js

Those are links shown from Web developer addons for FF from the docs site...see the image below.

That the site was created years ago by Bloc and the .js tools are from back then. Does illori know how to fix anything that may be broken? If she leaves the team how would we fix it? Things on the site should be able to be fixed by anyone on the team...people on the team should have a good working knowledge of TP but necessarily have to know everything about it. But with this we are talking about outside of TP coding that may or may not be updated or can be easily fixed.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 14, 2015, 08:02:11 AM
I get your point, but don't know enough about how code works to have any kind of opinion about what we should do. I agree that more than one person should be able to work on existing code and make repairs when needed, but how to get to that point?
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 14, 2015, 08:29:08 AM
Personally, I think new ideas need to be formed. TP is a great tool but cannot do everything. So, you use it to its full potential and then may need to use something else for the rest...like tracking bugs.

The docs site has old code for TP and themes and needs to be updated for security reasons, if nothing else. If we are working on it now then now is the time to get things organized and updated. How long has Xarcell been gone? Wasn't that the last time it was updated? The internet is always changing and websites need to keep up to stay on top. Security concerns is the most important reason why software needs to stay current. If you have another security problem like before then what happens?
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 14, 2015, 10:08:01 AM
Xarcell did a major redesign of the docs and wrote the 1.0 version docs and that was brought online by me in early 2008, he had built it up on one of his sites and then I copied the entire TP 1.0 Docs over from his site to a newly formed Docs site that Bloc stood up with the custom theme we're using today. I basically did the same as we are doing now... creating new categories/boards and populating them with topics of each doc.
Then later Carina and me did an update of the existing docs, but no where near as in depth as what Xarcell and I did earlier.

Somewhere along in there Xarcell drifted away, I think that by the time he finished his extensive work on the docs he became disenchanted with TP... as far as I remember he felt some members of TP Team were not giving him his due respect, but my memories are rather vague on that score, so I may be wrong.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 14, 2015, 02:03:46 PM
Yup! I remember when he started doing the docs. Bloc said he liked my tutorials and wanted to know if he could borrow the info or ideas. Of course, I said he could use whatever he wanted. And you're right about how some treated him.
Title: Re: TP Docs Rebuild/Update
Post by: Maxx on November 14, 2015, 03:00:48 PM
I have yet to find a portal, that does What Bloc has made and what TP is now.
Bloc May be set in his ways a bit, at times as am I,  but No one can put down his work, at any level.
I always respected his coding and designs.

And even though we had are disagreements. he is the best, on SMF related stuff among other projects he has worked on or with.

I was looking forward to seeing him back at it.
Also wanted to note that Bloc has made a few themes that have very nice tools tips, and other great functions.
I also feel that this type thing should be done in the themes and not in the portal for a few reasons.

 I will try to think of some things that maybe considered, but feel that TP, may be done in a more simplistic way, rather more complicated. the SMF seems to be going in the direction of many things that can be taken out of the portals.


JMHO
But I love TP!

regards,
Maxx

Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 14, 2015, 06:56:24 PM
I agree but think TP can be even more...
Title: Re: TP Docs Rebuild/Update
Post by: Mick on November 15, 2015, 06:16:06 AM
I agree but think TP can be even more...

I also agree, but until I find a proper developer it's not going to happen unfortunately.   :wink:

A lot of the stuff that's changed in TP over the last few months, and believe me it's a lot, is mainly down to making it compliant with the new coding standards which SMF require these days. Plus getting rid of gif images they use PNG for most of their stuff now.  So although you might not notice the changes there is a lot of them.  Even more so in TP 2 for smf 2.1 beta 2.  Must say that's looking rather good atm.
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 15, 2015, 06:28:49 AM
Yeah, I know and understand. ;)
Title: Re: TP Docs Rebuild/Update
Post by: Mick on November 15, 2015, 06:49:00 AM
Yeah, I know and understand. ;)

Thanks.  I will just add that if certain functions of TP don't work, and are not likely to work with future versions of SMF then there's no point trying to fix them. That's why some parts have been stripped out.  The main goal here is to keep it moving, with the idea of developing and improving later when we can. (or if we can).  1.1 is sort of feature locked, although if there's something simple which can be added (example, the built in Top Posters block) then we'll try and do so for TP1.1 and TP2.  Mainly it's bug fixes and code cleanups tbh, there's loads of dead code lying around from previous versions.
Title: Docs Update: Phase 3
Post by: Ken on November 21, 2015, 06:57:25 AM
Docs Update: Phase 3

Most of the boards and topics have been ported over from TP 1.0 and now we must go through them all to make sure that they are relevant to TP 1.1 and also that now were left out.
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 21, 2015, 09:47:40 AM
Blocks


Troubleshooting Blocks

How To Create A Block

... completed
Title: Re: TP Docs Rebuild/Update
Post by: Maxx on November 21, 2015, 01:57:04 PM
Ken,

Thanks again for the Updates and work you and the guys are doing. all the best!

regards
Maxx
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 22, 2015, 06:59:00 AM
Ok, I'll go over them...if those aren't the ones I've already went over. LOL
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 22, 2015, 08:34:48 AM
Ok, I'll go over them...if those aren't the ones I've already went over. LOL

They are, but... what we were going over before was actually the TP 1.0 files. Those have now all (most?) been copied over to the new TP 1.1 boards and those new topics are the ones we are going over now.
What I'm doing is posting the topics that I've been editing, starting from the beginning of the Docs.

So, if you go to This Topic (http://www.tinyportal.net/docs/index.php?topic=234.0) you will see the docs that I've reviewed and edited so far. If you would proofread those listed in each topic and then add any comments to each topic that would be great. 

This Topic (http://www.tinyportal.net/docs/index.php?topic=188.0) is an example of what the docs should look like. Almost all docs are going to require one image and many will require two images, as seen in the one in the link. So, if you see that an image has been left out, or doesn't actually fit well with the subject matter please make a note on that. And your usual proofreading details of course.

Thanks Steve.  :thumbup:
Title: Re: TP Docs Rebuild/Update
Post by: Skhilled on November 23, 2015, 09:02:45 AM
Okey-dokey...
Title: Re: TP Docs Rebuild/Update
Post by: Ken on November 23, 2015, 09:58:38 AM
Blocks Post Updated (http://www.ourfamilyforum.org/FamilyForum/index.php?topic=3756.msg14171#msg14171) (completed)

...more:


Articles Setup & Management


Modules: