https://www.icyphoenix.com/viewtopic.php?f=4&t=6459
-----------------------------------
Mighty Gorgon
Sat 12 Sep, 2009 09:40

ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
Hi,
I'll make a short example on how you can easily add your own configuration section to [b]ACP => Configuration => Icy Phoenix[/b].

[list=1][*]First step create a new empty file into [b]includes/mods_settings[/b] and call it as you like (you just need to make sure to have the prefix [b]mod_[/b] in front of it). For the benefit of this tutorial we will call it [b]mod_my_brand_new_config_section.php[/b].
[*]Fill the file with the config entries you need, these entries will be inserted automatically into [b]phpbb_config[/b] table (of course table prefix may be different for your own configuration). Here is an example which adds two vars one being YES/NO and the other a TEXT one:
[spoiler][codeblock]<?php
/**
*
* @package Icy Phoenix
* @version $Id$
* @copyright (c) 2008 Icy Phoenix
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
*
*/

if (!defined('IN_ICYPHOENIX'))
{
	die('Hacking attempt');
}

if (!defined('BOARD_CONFIG'))
{
	return;
}

include_once(IP_ROOT_PATH . 'includes/functions_mods_settings.' . PHP_EXT);
$mod_name = '120_My_Own_Mods';

$config_fields = array(

	'my_yes_no_var' => array(
		'lang_key' => 'IP_my_yes_no_var',
		'explain' => 'IP_my_yes_no_var_explain',
		'type' => 'LIST_RADIO',
		'default' => 'No',
		'values' => $list_yes_no,
		),

	'my_text_var' => array(
		'lang_key' => 'IP_my_text_var',
		'explain' => 'IP_my_text_var_explain',
		'type' => 'VARCHAR',
		'default' => 'write here your value',
		),

);

init_board_config($mod_name, $config_fields);

?>[/codeblock][/spoiler]
[*]You will now need to create language entries for all those new vars, and to do that let's create a brand new lang file so to avoid messing with standard Icy Phoenix files. Again the name could be as you like, but you need to pay attention to the prefix which in this case should be [b]lang_extend_[/b]. In this example let's suppose we have only English lang installed (if you have more than one lang you need to replicate this for any lang installed) and we will use this filename: [b]lang_extend_my_brand_new_lang_file.php[/b]. Of course the file have to be located into [b]language/lang_english/[/b] folder!
[*]The content of the file should be something like this:
[spoiler][codeblock]<?php
/**
*
* @package Icy Phoenix
* @version $Id$
* @copyright (c) 2008 Icy Phoenix
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
*
*/

/**
*
* @Extra credits for this file
* Lopalong
*
*/

if (!defined('IN_ICYPHOENIX'))
{
	exit;
}

if (empty($lang) || !is_array($lang))
{
	$lang = array();
}

$lang = array_merge($lang, array(
	'120_My_Own_Mods' => 'My Own Mods',
	)
);

// admin part
if ($lang_extend_admin)
{
	$lang = array_merge($lang, array(

		'IP_my_yes_no_var' => 'Enable My Own Var',
		'IP_my_yes_no_var_explain' => 'Enable this option will do nothing! <br /><b>Note:</b> Greetings From MG.',

		'IP_my_text_var' => 'My Text Var',
		'IP_my_text_var_explain' => 'Insert any text you like...',

	)
);

?>
[/codeblock][/spoiler]
[*]Now that everything has been created, we are ready to use our own vars everywhere in Icy Phoenix by just using:
[list][*]$board_config['my_yes_no_var']
[*]$board_config['my_text_var'][/list]
[*]Enjoy your new vars!!![/list]


You have created your own config section and vars without having edited a single Icy Phoenix file, did you expect it could be so easy? :mri:


-----------------------------------
Mighty Gorgon
Sat 12 Sep, 2009 09:54

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
I forgot to mention that you can use the same procedure to add new profile options for users... but that require some extra editing.

If someone is interested I may create extra instructions in the future... if someone would like to try on is own and report the results, is more than welcome. :lol:


-----------------------------------
Lopalong
Sat 12 Sep, 2009 10:23

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
Thank you MG!

I'll be testing this tomorrow to see what I can apply it to. ;)

[i]I hope you've got it right![/i] ROFL!  :mryellow:


-----------------------------------
DWho
Sun 13 Sep, 2009 16:54

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
Fantastic... work around...

I shall be looking at this for future modifications...

 :mrgreen:  :mrgreen:


-----------------------------------
spydie
Sun 13 Sep, 2009 18:29

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
[quote user="Mighty Gorgon" post="44305"]I forgot to mention that you can use the same procedure to add new profile options for users... but that require some extra editing.

If someone is interested I may create extra instructions in the future... if someone would like to try on is own and report the results, is more than welcome. :lol:[/quote]


Can´t wait to see more instructions. Thank´s MG


-----------------------------------
Jodi
Sat 14 Nov, 2009 09:44

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
[quote user="Mighty Gorgon" post="44303"]Hi,
I'll make a short example on how you can easily add your own configuration section to [b]ACP => Configuration => Icy Phoenix[/b].

[codeblock]
$mod_name = '120_My_Own_Mods';
[/codeblock]

[codeblock]
$lang = array_merge($lang, array(
	'120_My_Own_Mods' => 'My Own Mods',
	)
[/codeblock][/quote]
Hi,
I'm creating a new simple mod for icy phoenix and i would like to have some parameter to be editable from ACP.
What is unclear to me is the number 120 in the mod's name; i guess it is related to the position of my own configuration section within ACP.
Where can i find any information about it ?

Thanks in advance


-----------------------------------
Mighty Gorgon
Sun 15 Nov, 2009 11:06

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
Since currently there is no way to sort ACP modules via DB, sorting is performed alphabetically based on the lang var name.

That number is just an example, you can either remove or change it to suit your needs.


-----------------------------------
Jodi
Sun 15 Nov, 2009 11:12

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
[quote user="Jodi" post="45948"]
Hi,
I'm creating a new simple mod for icy phoenix and i would like to have some parameter to be editable from ACP.
What is unclear to me is the number 120 in the mod's name; i guess it is related to the position of my own configuration section within ACP.
Where can i find any information about it ?

Thanks in advance[/quote]
I posted the message above because my mod settings doesn't appeared in ACP and I guessed it was related to the number 120 in the mod's name.
To insert my mod settings in ACP has been necessary to remove the following lines from first example (file mod_my_brand_new_config_section.php):

[code linenumbers=false]
$is_allowed = check_acp_module_access();
if ($is_allowed == false)
{
    return;
}
[/code]
Are these lines related to a previous release of icyphoenix ?

I'm using icyphoenix 1.3.0.53


-----------------------------------
Mighty Gorgon
Sun 15 Nov, 2009 11:21

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
As I wrote at the beginning of the post, when you create a module using this way, it will be shown in [b]ACP => Configuration => Icy Phoenix[/b].

Try to check there.


-----------------------------------
Jodi
Sun 15 Nov, 2009 11:32

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
[quote user="Mighty Gorgon" post="45965"]As I wrote at the beginning of the post, when you create a module using this way, it will be shown in [b]ACP => Configuration => Icy Phoenix[/b].

Try to check there.[/quote]
My settings are shown in APC->Configuration->Icy Phoenix only if i comment out/remove the code above.


-----------------------------------
Mighty Gorgon
Sun 15 Nov, 2009 11:53

Re: ACP - How To Easily Add A Configuration Entry / Value To ACP
-----------------------------------
Yes, you are right.

Fixed first post.

Thanks


