Integrated "User Guide" in admin of Fuel doesn't works

futbolsalas15

First, I apologize if this part is not right to post solutions to bugs, but I don't know where to put it.

DESCRIPTION:

When I change the fuel_path configuration in fuel/application/config/MY_fuel.php (e.g $config['fuel_path'] = 'admin/') and I try to access to the user_guide module (e.g. http://mysite.com/admin/tools/user_guide), appears a blank page.

FIX:

Change the config variable "user_guide_root_url" (in fuel/modules/user_guide/config/user_guide.php, line 21) from:

$config['user_guide_root_url'] = FUEL_FOLDER.'/tools/'.USER_GUIDE_FOLDER.'/';

to

$config['user_guide_root_url'] = FUEL_ROUTE.'tools/'.USER_GUIDE_FOLDER.'/';

Because actually the user_guide_root_url points out to the fuel folder, not the real fuel url.

admin

Thanks for the report. That is actually fixed in the latest version of the user guide for 1.0:

https://github.com/daylightstudio/FUEL-CMS/tree/1.0
https://github.com/daylightstudio/FUEL-CMS-User-Guide-Module

lhagemann

with an install of version 0.9.3 from github, I too am seeing a 404 for the integrated user guide. (All other 'tools' are working fine)

I've made the above change to fuel/modules/user_guide/config/user_guid.php, but that doesn't help.

[code]
// the URI path to the user guide
$config['user_guide_root_url'] = FUEL_ROUTE.'/tools/'.USER_GUIDE_FOLDER.'/';
[/code]

P.S. new to the forums, where would I find markup reference?

admin

By default, you need to be logged into the CMS to see the user guide. Also, you may want to check your MY_fuel.php to see if "user_guide" is in the list of "modules_allowed".

For markup, you can use the "code" tag.

lhagemann

Yes, I was logged into the admin. Yes the User Guide is allowed. As I mentioned the other 'tools' modules are all working as expected.

in fuel/modules/user_guide/config/user_guide.php
// the URI path to the user guide $config['user_guide_root_url'] = FUEL_ROUTE.'/tools/'.USER_GUIDE_FOLDER.'/';

in application/config/MY_fuel.php
// path to the fuel admin from the web base directory... MUST HAVE TRAILING SLASH! $config['fuel_path'] = 'admin/'; $config['fuel_mode'] = 'auto'; // specifies which modules are allowed to be used in the fuel admin $config['modules_allowed'] = array( 'user_guide', 'blog', 'backup', 'seo', 'validate', 'tester', 'cronjobs' );

futbolsalas15

I suggest that remove the '/' in your route:
from

// the URI path to the user guide
$config['user_guide_root_url'] = FUEL_ROUTE.'/tools/'.USER_GUIDE_FOLDER.'/';

to

// the URI path to the user guide
$config['user_guide_root_url'] = FUEL_ROUTE.'tools/'.USER_GUIDE_FOLDER.'/';

lhagemann

Thank you futbolsalas15, that was in fact the problem.