Questions: Some Branding Basics

[sirbrent]

I am trying to learn the cpanel theming and branding process, which has been a fun adventure but not an easy task.

Say I have a branding called "hulahoop" for x3 skin, and I want to prepare this branding for distributing. I have learned that when using skins that if the file being requested exists in the set branding folder it will be used, if not it will look for the root branding. Simple and elegant. Yes.

My problem is with creating those damn sprite files. I cannot seem to get mine to be acknowledged (ones which I have put in my /branding/huluhoop folder, e.g.: icon_sprites_img.jpg & icon_sprites_img.jpg.map). I cant tell what files are being using when the sprites are rebuild (through script usage AND through "Reset All Icons" in branding interface). Where should my branding 'style's main page default icons' be specified. Basically I want to have some custom icons in my branding directory, and when the system rebuilds the sprites or a user is editing the "hulahoop" branding's sprites they will be the proper set.

I have started to learn a lot about cPanel's APIs and the way the skinning system works but there are a few things that I haven't been able to make sense of... and there doesn't seem to be any good documentation out there... nothing at all complete and comprehensive anyway --Please show me, if I am wrong!

Many thanks!

[cPanelDavidG]

Originally Posted by sirbrent

I am trying to learn the cpanel theming and branding process, which has been a fun adventure but not an easy task.

Say I have a branding called "hulahoop" for x3 skin, and I want to prepare this branding for distributing. I have learned that when using skins that if the file being requested exists in the set branding folder it will be used, if not it will look for the root branding. Simple and elegant. Yes.

My problem is with creating those damn sprite files. I cannot seem to get mine to be acknowledged (ones which I have put in my /branding/huluhoop folder, e.g.: icon_sprites_img.jpg & icon_sprites_img.jpg.map). I cant tell what files are being using when the sprites are rebuild (through script usage AND through "Reset All Icons" in branding interface). Where should my branding 'style's main page default icons' be specified. Basically I want to have some custom icons in my branding directory, and when the system rebuilds the sprites or a user is editing the "hulahoop" branding's sprites they will be the proper set.

I have started to learn a lot about cPanel's APIs and the way the skinning system works but there are a few things that I haven't been able to make sense of... and there doesn't seem to be any good documentation out there... nothing at all complete and comprehensive anyway --Please show me, if I am wrong!

Many thanks!

Are you just placing files in the branding directory or are you adding them via the Branding Editor? I recommend using the Branding Editor since that will handle all the sprite stuff for you.