{"id":883,"date":"2021-07-23T12:40:20","date_gmt":"2021-07-23T12:40:20","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/customization\/"},"modified":"2021-07-23T12:40:20","modified_gmt":"2021-07-23T12:40:20","slug":"customization","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/customization\/","title":{"rendered":"Customization"},"content":{"rendered":"<\/p>\n
\n
\n
\n

Valid for versions 82 through the latest version<\/em><\/p>\n<\/div>\n

\n

Version:<\/h4>\n

82<\/h4>\n<\/div><\/div>\n
\n

Overview<\/h2>\n
\n
Note:<\/div>\n
\n

Changes made in this interface (aside from Public Contact) only<\/strong> apply to the Paper Lantern theme.<\/p>\n<\/p><\/div>\n<\/div>\n

This interface allows you to customize parts of the cPanel and Webmail interfaces. You can:<\/p>\n

    \n
  • \n

    Upload custom logos.<\/p>\n<\/li>\n

  • \n

    Upload a favicon.<\/p>\n<\/li>\n

  • \n

    Update parts of the cPanel interface to match your company\u2019s branding.<\/p>\n<\/li>\n

  • \n

    Upload custom cPanel styles.<\/p>\n<\/li>\n

  • \n

    Update the contact information on publicly-visible placeholder pages.<\/p>\n<\/li>\n<\/ul>\n

    For the purposes of cPanel, L.L.C.\u2019s products and documentation, we use the following terms:<\/p>\n

      \n
    • \n

      Branding<\/strong> \u2014 Branding modifies the cPanel interface in order to match your company\u2019s logo and brand.<\/p>\n

        \n
      • \n

        Branding changes include updates to image assets or text labels.<\/p>\n<\/li>\n

      • \n

        For more information, read our Branding documentation.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n

      • \n

        Includes<\/strong> \u2014 UI includes add custom content to the header or footer of the cPanel interface (but not the WHM interface).<\/p>\n

          \n
        • \n

          You can create UI includes for specific cPanel interfaces, or global UI includes that display on all of cPanel\u2019s interfaces.<\/p>\n<\/li>\n

        • \n

          For more information, read our UI Includes documentation.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n

        • \n

          Plugin<\/strong> \u2014 A plugin modifies an interface\u2019s features or functionality, and it may also include changes to the interface\u2019s appearance.<\/p>\n

            \n
          • \n

            You can write plugins for the cPanel or WHM interfaces.<\/p>\n<\/li>\n

          • \n

            You can use the cPanel Style Guide to ensure that your interfaces match the appearance of standard cPanel interfaces.<\/p>\n<\/li>\n

          • \n

            For more information, read our Guide to cPanel Plugins documentation.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n

          • \n

            Style<\/strong> \u2014 A style uses CSS, images, and other assets to modify the appearance of the entire cPanel interface without changes to its functionality or features.<\/p>\n

              \n
            • \n

              You can create and apply styles to an entire server or a specific reseller\u2019s accounts, or you can create them for distribution.<\/p>\n<\/li>\n

            • \n

              For more information, read our cPanel Style Development documentation.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n

            • \n

              Theme<\/strong> \u2014 A theme applies an overlay on the skeletal framework for all of the interfaces.<\/p>\n

                \n
              • \n

                cPanel & WHM currently ships with one default cPanel theme and one default WHM theme.<\/p>\n<\/li>\n

              • \n

                The Webmail and login interfaces also use themes.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n

                Customize Branding<\/h2>\n

                To customize the cPanel or Webmail interfaces:<\/p>\n

                  \n
                1. \n

                  Enter your company\u2019s name in the Company Name<\/em> text box to brand the interface with your company name.<\/p>\n

                    \n
                  • \n

                    Use this option if you don\u2019t want to upload a custom logo.<\/p>\n<\/li>\n

                  • \n

                    If you use this option, your company name will appear in the default cPanel font. <\/p>\n

                    \n
                    Note:<\/div>\n
                    \n
                      \n
                    • \n

                      To change the font style, you must<\/strong> customize cPanel\u2019s CSS with a custom style.<\/p>\n<\/li>\n

                    • \n

                      The Company Name<\/em> value cannot<\/strong> exceed 50 characters. The cPanel interface truncates it if the name\u2019s width exceeds the width of the user\u2019s browser window.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n<\/li>\n<\/ul>\n<\/li>\n

                    • \n

                      Enter your help or support URL in the Help Link<\/em> text box to customize the Help<\/em> link. The Help<\/em> link won\u2019t<\/strong> appear in the cPanel interface until you enter a custom URL.<\/p>\n<\/li>\n

                    • \n

                      Enter your documentation URL in the Documentation Link<\/em> text box to customize the Documentation<\/em> link. If you don\u2019t enter a custom Documentation<\/em> link, the Documentation<\/em> link points to the cPanel, L.L.C. documentation.<\/p>\n<\/li>\n

                    • \n

                      Click Browse<\/em> under the desired heading to add your company logo, Webmail logo, or favicon. Then, select the desired file.<\/p>\n

                      \n
                      Note:<\/div>\n
                      \n
                        \n
                      • \n

                        cPanel & WHM has specific icon size and file type requirements. For more information, read our Guide to cPanel Interface Customization – Custom Icons and Logos documentation.<\/p>\n<\/li>\n

                      • \n

                        If you upload a file with this interface, the system saves it as an .svg<\/code> file.<\/p>\n<\/li>\n

                      • \n

                        To delete an uploaded logo, click the trash can icon () for that image file.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n<\/li>\n

                      • \n

                        To apply your changes, click Save<\/em>.<\/p>\n<\/li>\n<\/ol>\n

                        Customize Style<\/h2>\n
                        \n
                        Note:<\/div>\n
                        \n

                        You can download an example skeleton style to help you create a new style.<\/p>\n<\/p><\/div>\n<\/div>\n

                        Upload a custom style<\/h3>\n

                        To upload custom cPanel styles:<\/p>\n

                          \n
                        1. \n

                          Click Upload a Style<\/em>.<\/p>\n<\/li>\n

                        2. \n

                          To select a style to upload, click Browse<\/em>.<\/p>\n

                            \n
                          • \n

                            The system uses the .tar.gz<\/code> file\u2019s name as the style\u2019s name.<\/p>\n<\/li>\n

                          • \n

                            You must<\/strong> upload your custom style as a .tar.gz<\/code> file, which must<\/strong> contain the styles.css<\/code> file, the styles.min.css<\/code> file, or both. <\/p>\n

                            \n
                            Note:<\/div>\n
                            \n

                            We strongly<\/strong> recommend that you include both<\/strong> files.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n<\/ul>\n<\/li>\n

                          • \n

                            To set the style as the default style, select the Set this style as my default style<\/em> checkbox.<\/p>\n<\/li>\n

                          • \n

                            Click Upload<\/em>. <\/p>\n

                            \n
                            Important:<\/div>\n
                            \n

                            We strongly<\/strong> recommend that you keep your custom styles up to date to avoid compatibility issues when you upgrade cPanel & WHM. To do this, perform the following actions:<\/p>\n

                              \n
                            • \n

                              Monitor our Change Logs and our Release Notes documentation for updated features and bug fixes.<\/p>\n<\/li>\n

                            • \n

                              Make certain<\/strong> that your server runs on the LTS, STABLE, RELEASE, or CURRENT release tiers, so that it receives any functionality updates.<\/p>\n<\/li>\n

                            • \n

                              You can also use a server that runs on the EDGE release tier to test for compatibility and functionality in a controlled environment.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n<\/li>\n<\/ol>\n

                              Manage styles<\/h3>\n
                              \n
                              Important:<\/div>\n
                              \n

                              To modify the theme or style for existing accounts, use the \/usr\/local\/cpanel\/scripts\/modify_accounts<\/code> script.<\/p>\n<\/p><\/div>\n<\/div>\n

                              Use the Manage Styles<\/em> section to work with styles. To filter the list of styles, click the desired filter name.
                              \nFor each style, you can perform the following actions:<\/p>\n

                                \n
                              • \n

                                Set as Default<\/em> \u2014 Click to set a style as the default style for your newly-created accounts.<\/p>\n

                                \n
                                Note:<\/div>\n
                                \n

                                This action only<\/strong> sets the default for new accounts that you create. It does not<\/strong> set the style for existing accounts on the server.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n

                              • \n

                                Set as Default<\/em> \u2014 Click to set a style as the default style for your newly-created accounts.<\/p>\n

                                \n
                                Note:<\/div>\n
                                \n This action only<\/strong> sets the default for new accounts that you create. It does not<\/strong> set the style for existing accounts on the server.\n <\/div>\n<\/div>\n<\/li>\n
                              • \n

                                Download Style<\/em> \u2014 Click to download the style. You may wish to download existing styles to customize them or use them as a base for new styles.<\/p>\n<\/li>\n

                              • \n

                                Delete<\/em> \u2014 Click the trash can icon () to delete a style. Then, click Delete<\/em> again to confirm the deletion.<\/p>\n

                                \n
                                Note:<\/div>\n
                                \n

                                You can only<\/strong> perform this action on styles that you uploaded and own.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n

                              • \n

                                Delete<\/em> \u2014 Click the trash can icon () to delete a style. Then, click Delete<\/em> again to confirm the deletion.<\/p>\n

                                \n
                                Note:<\/div>\n
                                \n You can only<\/strong> perform this action on styles that you uploaded and own.\n <\/div>\n<\/div>\n<\/li>\n<\/ul>\n

                                Public Contact<\/h2>\n
                                \n
                                Important:<\/div>\n
                                \n
                                  \n
                                • \n

                                  We strongly recommend<\/strong> that you update this. Otherwise, customers see the default information, which may hurt your brand.<\/p>\n<\/li>\n

                                • \n

                                  The cPanel interface will not<\/strong> show the company name that you enter in the Customize Branding<\/em> tab on placeholder pages.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n

                                  The Account Suspended and Default Webpage interfaces show visitors your contact information. Users will also see it when they search for your contact information.<\/p>\n

                                    \n
                                  • \n

                                    Resellers who own their accounts can add custom information to their main domains.<\/p>\n<\/li>\n

                                  • \n

                                    Main domains for other resellers use the server owner\u2019s information.<\/p>\n<\/li>\n<\/ul>\n

                                    For example, when the system displays a placeholder page to a user, they may see the following message:\n<\/p>\n

                                    \n
                                    If you are the owner of this website, please contact your hosting provider: webmaster@10.0.2.0<\/code><\/pre>\n<\/div>\n
                                    In this example, webmaster@10.0.2.0<\/code> is a link to the hosting provider\u2019s default contact email address. If you update this information, you can choose a specific email address or URL instead.<\/p>\n
                                    For information on how to remove this information from the Account Suspended<\/em> and Default Webpage site<\/em> templates, read our Web Template Editor documentation.<\/p>\n
                                    Customize contact information<\/h3>\n
                                    To enter your public contact information:<\/p>\n
                                      \n
                                    1. \n
                                      Enter your company\u2019s name in the Public Company Name<\/em> text box.<\/p>\n<\/li>\n
                                    2. \n
                                      Enter your company\u2019s URL in the Public Contact URL<\/em> text box.<\/p>\n<\/li>\n
                                    3. \n
                                      Click Save<\/em>.<\/p>\n<\/li>\n<\/ol>\n
                                      File locations<\/h2>\n
                                      cPanel & WHM stores branding information in the reseller_info.json<\/code> file, which exists in either the root<\/code> user\u2019s or reseller\u2019s brand directory.<\/p>\n
                                        \n
                                      • \n
                                        If the reseller who owns the account has specified custom branding information, the cPanel user sees the reseller\u2019s branding in the cPanel interface.<\/p>\n<\/li>\n
                                      • \n
                                        If the reseller has not<\/strong> specified custom branding information, but the root<\/code> user has<\/strong>, the cPanel user sees the root<\/code> user\u2019s branding in the cPanel interface.<\/p>\n<\/li>\n
                                      • \n
                                        If neither the reseller nor the root<\/code> user have specified custom branding information, the cPanel user does not<\/strong> see any customizations to the cPanel interface.<\/p>\n<\/li>\n<\/ul>\n
                                        When you save your customizations through this interface, the system stores your items in the following directories:<\/p>\n
                                        \n
                                        Note:<\/div>\n
                                        \n
                                          \n
                                        • \n
                                          resellername<\/code> represents the reseller\u2019s username.<\/p>\n<\/li>\n
                                        • \n
                                          stylename<\/code> represents the style\u2019s name. For example, if you upload the mystyle.tar.gz<\/code> file, the system stores the style\u2019s files in the \/home\/resellername\/var\/cpanel\/reseller\/styled\/mystyle<\/code> directory.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n
                                          Reseller<\/strong><\/p>\n\n\n\n\n\n\n\n\n
                                          Item<\/th>\nFile path<\/th>\nFile name<\/th>\n<\/tr>\n<\/thead>\n
                                          Favicon<\/td>\n\/home\/resellername\/var\/cpanel\/reseller\/brand<\/code><\/td>\nfavicon.ico<\/code><\/td>\n<\/tr>\n
                                          Logo<\/td>\n\/home\/resellername\/var\/cpanel\/reseller\/brand<\/code><\/td>\nlogo.svg<\/code> or<\/strong> logo.png<\/code><\/td>\n<\/tr>\n
                                          Webmail logo<\/td>\n\/home\/resellername\/var\/cpanel\/reseller\/brand<\/code><\/td>\nwebmail.svg<\/code> or<\/strong> webmail.png<\/code><\/td>\n<\/tr>\n
                                          Custom styles<\/td>\n\/home\/resellername\/var\/cpanel\/reseller\/styled\/stylename<\/code><\/td>\nN\/A<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                          Root<\/strong><\/p>\n\n\n\n\n\n\n\n\n
                                          Item<\/th>\nFile path<\/th>\nFile name<\/th>\n<\/tr>\n<\/thead>\n
                                          Favicon<\/td>\n\/var\/cpanel\/customizations\/brand<\/code><\/td>\nfavicon.ico<\/code><\/td>\n<\/tr>\n
                                          Logo<\/td>\n\/var\/cpanel\/customizations\/brand<\/code><\/td>\nlogo.svg<\/code> or<\/strong> logo.png<\/code><\/td>\n<\/tr>\n
                                          Webmail logo<\/td>\n\/var\/cpanel\/customizations\/brand<\/code><\/td>\nwebmail.svg<\/code> or<\/strong> webmail.png<\/code><\/td>\n<\/tr>\n
                                          Custom styles<\/td>\n\/var\/cpanel\/customizations\/styled\/stylename<\/code><\/td>\nN\/A<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                          \n
                                          Note:<\/div>\n
                                          \n        The system checks for a .svg<\/code> logo first. If no .svg<\/code> logo exists, the system uses the .png<\/code> logo, if one exists.\n    <\/div>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"
                                          Valid for versions 82 through the latest version Version: 82 Overview Note: Changes made in this interface (aside from Public Contact) only apply to the Paper Lantern theme. This interface allows you to customize parts of the cPanel and Webmail interfaces. You can: Upload custom logos. Upload a favicon. Update parts of the cPanel interface …<\/p>\n","protected":false},"author":1,"featured_media":884,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/883"}],"collection":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/comments?post=883"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/883\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/884"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=883"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=883"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=883"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}