Discussion Forums  >  Self Hosted Control Panels

Replies: 5    Views: 346

Grateful
buzztouch Evangelist
Profile
Posts: 69
Reg: Dec 03, 2012
Long Beach
5,340
05/18/13 04:57 PM (12 years ago)

Customizing the Self-Hosted Control Panel

Are there any simple guides of what we need to do, or what documents are at the core for customizing a self-hosted control panel?
 
chris1
Code is Art
Profile
Posts: 3862
Reg: Aug 10, 2012
Austin, TX
50,120
like
05/18/13 06:07 PM (12 years ago)
What kind of customization are you trying to do?
 
SmugWimp
Smugger than thou...
Profile
Posts: 6316
Reg: Nov 07, 2012
Tamuning, GU
81,410
like
05/18/13 08:13 PM (12 years ago)
Most of the modifications for self hosting are usually found at buzztouchmods, run by Mr. David. Modifying your self hosted will require some PHP/MySQL knowledge, usually. https://www.buzztouchmods.com Cheers! -- Smug
 
Grateful
buzztouch Evangelist
Profile
Posts: 69
Reg: Dec 03, 2012
Long Beach
5,340
like
05/18/13 09:05 PM (12 years ago)
Hi Chris1 and Smug. I just made some simple changes I wanted. I would like to go deeper in changing things around but thats something which I may do later. Thanks for responding. Ill keep you posted if I run into a very specific issue I need help with.
 
David @ buzztouch
buzztouch Evangelist
Profile
Posts: 6866
Reg: Jan 01, 2010
Monterey, CA
78,840
like
05/18/13 11:34 PM (12 years ago)
Some basics: There are three core "areas" in the control panel. -Account -Admin -App You'll always be working in one of these areas. When you login you'll arrive at your account screen. This is BT-server/account/index.php. If you click the admin link (assuming you have admin privileges), you'll arrive at BT-server/admin/index.php. When you click an app's name in the control panel you'll arrive at BT-server/bt_v15/bt_app/index.php. This should be BT-server/app/index.php but it's not, it will be eventually - it would make far more sense that way! Legacy code - ugh. So, three areas. If you look around in the .php files you'll see a file for each type of action. account/email.php, admin/users.php, etc. You're welcome to modify any of these screens as necessary. You'll want to avoid making changes to the files used to manage apps until you're sure you know what you're changing. Files: the BT-server/files directory is writable and the subfolders in this folder are created during the install. All sorts of files are written to /files, some temporary, some permanent. Temp files are created in /files/temp. All the other /files/[FOLDERS] should not be removed after they are created. Example: Each app has it's own directory structure in /files/applications and should not be removed after an app is created. Style: The core style sheet comes from BT-server/files/theme folder. You can change the CSS Style sheet (theme) that's used by copying the existing theme and uploading your own. After doing this, point to this new theme by changing the APP_THEME_PATH value in the config.php file. Which reminds me, the config.php file is used to manage global options like the install's URL, File Path, theme directory and all sorts of other stuff. The BT-server/includes folder holds all sorts of class files used to manipulate data and other properties while use the app. Example: The class.Page.php file is used by all the .php screens to create the HTML for the header, nav bar, footer, etc. Adding screens: Adding a screen is usually done by first adding it to /account, /admin or another directory. After doing this you would then add a link to your new screen in the navigation panel on the left of /account, /admin, the app's index.php page or whatever. Adding new screens is common because most of the Self Hosted installs are customized for a particular client, customer, or other implementation. It's common to deliver an app project to a client along with a control panel to allow you clients to manage their app. In many cases developers make the app, install the control panel (on the customers host or a newly configured host) and charge ongoing fees to manage the setup. There are lots of ways to do this and you're free to explore whatever suits your needs best. Official documentation - someday - we hope :-)
 
Grateful
buzztouch Evangelist
Profile
Posts: 69
Reg: Dec 03, 2012
Long Beach
5,340
like
05/19/13 06:01 AM (12 years ago)
Thanks David. That's very helpful. Exactly what I was looking for.
 

Login + Screen Name Required to Post

pointerLogin to participate so you can start earning points. Once you're logged in (and have a screen name entered in your profile), you can subscribe to topics, follow users, and start learning how to make apps like the pros.