+
+ |
++ + | +
+ + + + + + + + + + + + + + + +
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 12 + + + + + +Advanced Mozilla Customizations +
+ +After you've run the CCK tool, produced an installer, and made any manual customizations you may require for the CD autorun screen, you can perform additional manual customizations before distributing the installer to your users. This chapter provides an overview of the preferences architecture and the general procedure for manual customization. It also provides detailed, step-by-step instructions for some of the most common manual customizations. +
++ +This chapter contains these sections: +
++ +Understanding How Manual Customization Works
+
Understanding the Preferences Architecture
Before You Start
Editing a Configuration File with a Text Editor
Instructions for Common Manual Customizations ++ + +Understanding How Manual Customization Works +
+ + ++ +Mozilla is shipped with many preferences and user-interface items preset as "factory defaults." After Mozilla is installed, these settings are stored in special Javascript files called configuration files. +
++ +You can edit configuration files to customize the default settings for your users. For example, you can manually customize: +
++ +
+- +The Welcome page that appears at startup + +
+
+ +- +Proxy settings + +
+ +- +Any items that appear in the Help menu in Mozilla (both text and URLs) + +
+ +- +Password requirements, such as whether an email password is remembered or needed for each session + +
++ +To create a customized Mozilla installer by using a combination of the CCK tool and manual customizations, you follow this general procedure: +
++ +
+- +Complete all customizations that can be performed with the CCK tool and use the tool to build the installer. The installation files will be located in the directory + +
++
+ +- +where configuration_name is the configuration name you specified (or selected) for your customized configuration in the first screen of the CCK tool. +
- +Verify your customizations and run the CCK tool again, if necessary, to adjust them. + +
+ +- +Identify the preferences you want to change and the Javascript files that specify them. Table 1 below specifies the main Javascript files involved. Detailed information on specific preference entries within those files will be available online at a later time; see Mozilla 1.4.1 Client Customization Kit Release Notes for the most current information. XXX we need to host docs like this at www.mozilla.org + +
+ +- +Identify the xpi files in the installation files produced by the CCK Tool that contain the JavaScript files you want to change. (Table 1 below specifies the which xpi files contain which JavaScript files.) + +
+ +- +For each xpi file involved: + +
++ +
+ +- +Use a utility such as WinZip to extract the entire xpi file into some convenient temporary directory. + +
+- +Locate the JavaScript files that you want to modify in the extracted files. + +
+- +Use a text editor to modify the JavaScript files. + +
+- +Use a utility such as WinZip to zip up all the files you extracted from the xpi, including the ones you modified. + +
+- +Replace the old xpi file with your new xpi file.
+ +- +After you have modified the necessary JavaScript files and replaced the old xpi files with the revised xpi files, run the installer and test the resulting Mozilla installation to ensure that your customizations have taken effect. + +
++ +For step-by-step instructions describing this procedure more precisely for specific manual customizations, see single change to a JavaScript file, see Instructions for Common Manual Customizations. +
++ + +Understanding the Preferences Architecture +
+ + ++ +Factory defaults are set in
+.jsfiles, which are in turn located in zipped.xpifiles in the directory ++ +The primary
+.jsfile isall-ns.js, which is located in the filebrowser.xpi. ++ +Note: If you make changes to preferences stored (after installation) in the
+prefs.jsfile, where the user-configurable customizations are stored, you run the risk of overwriting the bookmarks, address books, and other settings that your users may have set in their existing profiles. ++ + +Table 12-1 JavaScript files to edit +
+
++ +Setting a preference in one of the
+.jsfiles will create a default value that can be changed by the user by choosing Preferences from the Edit menu. Not all preferences are initialized at startup via these.jsfiles. In addition, some settings are stored in RDF files that live in the operating system's directory after the user installs Mozilla. For example, for Windows NT, the path would be: ++ + +Important Legal Restrictions +
+ + ++ +The license that ships with the CCK tool imposes restrictions on certain kinds of customizations. In particular, under the terms of the license agreement, you may NOT perform any of the following customizations: +
++ +
+- +Remove the Search and Directory folder from its location in the Bookmarks menu when you open a new profile with Mozilla 1.4.1. + +
+ +- +Remove or modify the contents of the Search and Directory folder in the Bookmarks menu. + +
+ +- +Change the My Sidebar tab that is open by default when you open a new profile with Mozilla 1.4.1 (currently the News tab). + +
+ +- +Remove the Search or Today's Tips sidebar tabs from the My Sidebar tabs shown by default when you open a new profile with Mozilla 1.4.1. + +
+ +- +Remove any of the My Sidebar tabs from the list of tabs available to an end user in the default drop-down list of sidebar tabs available when you open a new profile with Mozilla 1.4.1. (It's OK to add additional tabs). + +
+ +- +Change the default Search service to which the Location Bar Search button and other search services are linked. + +
+ +- +Change the page that opens by default when Mail starts up. + +
+
+ + ++ +The CCK tool allows you to customize specific aspects of the look and feel of Mozilla. In addition, by editing
+all.jsand other configuration files, you can customize almost any aspect of Mozilla. You'll need to familiarize yourself with the Mozilla user interface and associated preferences to assess how to customize Mozilla for your needs. You'll also need to identify: ++ +
+- +The configuration file (typically a JavaScript file) involved + +
+ +- +The name of the preference within that configuration file. + +
+ +- +The
.xpifile where the configuration file is located in the installation files produced by the CCK tool. + +
++ +More details about names of specific preferences and the configuration files where they are stored will be provided online. See the Mozilla 1.4.1 Client Customization Kit Release Notes for the most current information. XXX - need mozilla.org equiv +
++ +Some Mozilla features or attributes are under user control, but only indirectly. Such features include whether certain toolbars are displayed, and also settings that Mozilla remembers automatically, such as window size and position. Such settings are not "preferences" in the typical sense, because they cannot be set from a user-selected window or dialog box. Instead, these features are referred to as Mozilla "states." +
++ +In addition to the preferences that you can set, you can alter Mozilla configuration settings that are not under direct or indirect user control, such as the items that appear in the Help menu. +
++ + +Editing a Configuration File with a Text Editor +
+ + ++ +By editing
+all-ns.jsand other configuration files directly, you can modify Mozilla in a variety of ways. You should use a simple text editor (one that doesn't do any formatting) to modify a configuration file. For example, you can use NotePad for Windows, SimpleText for Mac OS, or vi for X-Motif. If you use a word processor to edit the configuration file, make sure you save the edited configuration file as plain (ASCII) text. If formatted characters are used, the configuration file may not be created correctly. ++ +As described above under Understanding How Manual Customization Works, once you have extracted the
+.jsfile that you want to modify from the xpi file, you can edit it with a text editor. To do so, you must determine the value type that the preference takes (numeric, string, or boolean) and make the required change to produce the default setting that you want. ++ +Important: Don't use Mozilla Composer to edit configuration files. Composer adds characters to the file that can interfere with its use as a configuration file. +
++ + +Instructions for Common Manual Customizations +
+ + ++ + +Customizing the Welcome Page +
+ + ++ +The Welcome page appears when the user starts up a new profile for the first time. You may want to customize it so you can provide up-to-date information for new users when they first launch Mozilla. +
++ +Follow these steps to manually customize the URL specified for the Welcome page: +
++ +
+ +- +Locate this file: + +
+ +- +Unzip the entire file
browser.xpiinto a convenient empty directory. + +
+ +- +In the directory containing the extracted files, locate the file
bin/defaults/pref/all-ns.js. + +
+ +- +Open
all-ns.jswith a text editor. + +
+ +- +Locate this line: + +
++
- +Change the URL to the URL for your own welcome page and save the file. + +
+ +- +Zip up the entire
bindirectory again into a new file calledbrowser.xpi. + +
+ +- +Replace the original
browser.xpifile inCCKTool\Configs\my_config\Core\with the newbrowser.xpi. + +
+ +- +Test your customization. + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/browser_cck.htm b/mozilla/cck/CCKDocs/browser_cck.htm new file mode 100644 index 00000000000..ffab43d7575 --- /dev/null +++ b/mozilla/cck/CCKDocs/browser_cck.htm @@ -0,0 +1,1005 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 5 + + + + + +Preparing to Customize the Mozilla Browser +
+ +The CCK tool presents three screens that allow you to customize different aspects of the Mozilla browser. This chapter describes the information and files you need to prepare for these three screens. +
++ +This chapter contains these sections: +
++ +Creating a Custom Animated Logo
+
Determining a Help URL and Menu Item
Determining the Name of the Program Folder in the Windows Start Menu
Preparing a Customized Read-me File
Creating Your Own Sidebar Tab
Specifying the Default Home Page
Preparing Your Customized Bookmarks and Personal Toolbar
Determining Text for the Browser Window's Title Bar
Checklists for Customizing the Browser ++ + +Creating a Custom Animated Logo +
+ + ++ +You can replace the standard Mozilla animated logo that appears in the browser and mail windows with an animated logo for your own company, such as this one for MyISP:
++ +
++ +If you wish, you can also change the URL for the animated logo button to the URL for your home page, so that when users click the animated logo, they go to your home page instead of
+www.mozilla.org. ++ +The animated logo consists of a composite
+.GIFfile that contains two or more individual.GIFimages, or frames, laid end-to-end. When the individual frames in the composite.GIFfile are displayed in rapid succession, one after the other, the logo graphic takes on the appearance of motion. ++ +Here is a series of separate
+.GIFfiles that can be used to construct an animated.GIFfile:+ +
++ +To create your own animated logo, you'll need these tools: +
++ +
+- +A graphics editing program or 3D animation program to create the individual
.GIFfiles, or frames. + +
+ +- +A
.GIFfile animation program that assembles individual .GIF files into one continuous animated.GIFfile. + +
++ +You'll need to create the following: +
++ +
+- +A static
.GIFfile (32 by 32 pixels) for the at-rest logo. + +
+ +- +An animated
.GIFfile (32 by 32 pixels) for the animated logo. + +
++ +The browser uses the static
+.GIFfile whenever the animated logo is at rest (not animating). When both files are ready, put them in theWorkspace\AnimLogodirectory for your configuration. ++ +The sections that follow outline the steps involved in creating your static and animated
+.GIFfiles. ++ + +Step 1: Create the Animation Frames +
+ + ++ +You'll need to create the following
+.GIFfiles (frames): ++ +
+- +Up to 40 (32 pixels by 32 pixels)
.GIFfiles for assembling into the animated logo + +
+ +- +One GIF file (32 pixels by 32 pixels) that will be used as the "still" image when the animation is at rest + +
++ +Using a graphics editing program or a 3D animation program, create and save each individual animation frame as a separate
+ +.GIFfile. Keep the animation as simple as possible by using the fewest number of frames that convey the motion you want to achieve. ++ +
+- +Create no more than 40 frames (files) for the animated logo + +
+ +- +Save your files in
.GIFformat + +
+ +- +Use no more than 30 colors in each file; 16 colors are best. + +
++ + +Step 2: Assemble Your Frames Using a GIF Animation Program +
+ + ++ +Using your GIF file animation program: +
++ +
+- +Assemble the animation frames in the order in which you want them to appear. + +
+ +- +Set the duration that each frame will appear. + +
+ +- +Set the animation to loop infinitely. + +
+ +- +Preview the animation and make any changes until you're satisfied with the results. + +
+ +- +Save the animation as a
.GIFfile. + +
+ +- +Optimize the animation file. Most
.GIFanimation programs allow you to perform some optimization operations that will reduce the size of your animation file. + +
++ +Note: The animation will play more slowly on computers with slower processors. +
++ + +Determining a Help URL and Menu Item +
+ + ++ +The CCK Tool allows you to add a Help menu item to the Help menu. The name you specify appears as a new menu item above the Release Notes menu item near the bottom of the browser's Help menu. For example: My ISP Customer Support. +
++ +If you specify a new Help menu item, you must also specify a live URL for the page to which your menu item will take users and provide appropriate content for that page. +
++ + +Determining the Name of the Program Folder in the Windows Start Menu +
+ + ++ +To increase customer awareness of your company name and promote your company's identity to your customers, you can add your company name to the Mozilla 1.4.1 program folder name in the Windows Start menu. +
++ +For example, if you specify MyIsp for use with the Start menu, the program folder name in the Start menu appears as "Mozilla by MyIsp" as shown here:
++ +
++ + +Preparing a Customized Read-me File +
+ + ++ +Mozilla includes a standard read-me file, which you might want to customize if you want to provide additional information to your customers. +
++ +Under the terms of the Browser Customization Guidelines, you can edit the existing read-me file or replace it with one of your own, but you must not rename it. +
++ +To edit the read-me file: +
++ +
+- +Locate the standard Mozilla Read Me (
readme.txt) file: + +
+ + +- +Copy the
readme.txtfile to your own Workspace directory + +
+ ++ +Using a standard text editor such as WordPad, edit
+readme.txtor replace its contents with your own information. When the file is ready, put it at the top level of theWorkspacedirectory for your configuration (for easy access when you run the CCK tool). ++ + +Creating Your Own Sidebar Tab +
+ + ++ +Sidebar tabs provide a place within the Mozilla 1.4.1 browser for users to keep connected to what is most important to them. Tabs are a great place for favorite information, such as stock quotes, local weather, news headlines, sports headlines, local events, or horoscopes. Users can choose from a wide variety of tabs in the Sidebar Directory. +
++ +Mozilla 1.4.1 comes with several sidebar tabs already set up. However, you can customize the browser by adding, removing, and rearranging tabs for your users. By creating a sidebar tab, you give your content constant presence within the user's client software. This means that users always have access to your service or content even when they are on another web site or using email. Links in your tab can lead back to your web site, driving increased traffic; and you can reduce service calls by making technical information easily accessible through your sidebar tab. +
++ +The sidebar can appear on the left side of browser and mail windows of Mozilla 1.4.1. Here's an example of a custom sidebar tab for MyISP:
++ +
++ +To create a sidebar tab, see the instructions posted at +
+
+
+ + +http://home.netscape.com/sidebar + +++ +To add or rearrange the tabs that appear, see the following sections. After you have created your own sidebar tab and made other modifications to the sidebar tabs displayed, you should store the file
+ + + +panels.rdfin yourWorkspace/Sidebardirectory for easy access when you run the CCK tool. ++ +In addition to providing your own sidebar tab, you can select from a wide range of existing sidebar tabs to customize the default tabs available when your customers open a new Mozilla profile for the first time. +
++ +For a continuously updated directory of available sidebar tabs, see +
+
+
+ + +http://channel.netscape.com/sidebar/sbd/index.tmpl + +++ +For additional information about developing sidebar tabs, see +
++ +It possible to add a sidebar tab simply by clicking a link. You can also control which sidebar tabs appear from within the Sidebar frame itself: +
++ +
+- +Start the Mozilla browser. + +
+ +- +Click Tabs at the top of Sidebar, then choose Customize Sidebar. + +
+ +- +Select one or more tabs from the list on the left. You can open and close folders by double-clicking their names. + +
+ +- +Click Add. + +
+ +- +Click OK to finish. + +
++ + +Rearranging Sidebar Tabs +
+ + ++ +To change the position of one of the Sidebar tabs displayed by the browser, follow these steps: +
++ +
+ +- +In the browser, click Tabs at the top of Sidebar, then choose Customize Sidebar. + +
+ +- +Select a tab from the list on the right. + +
+ +- +Click Up or Down to change the tab's placement. + +
+ +- +Click OK to finish. + +
++ +
+- +Change the Sidebar tab that is open by default when you open a new profile with Mozilla 1.4.1 (currently the News tab). + +
+ +- +Remove the Search or Today's Tips sidebar tabs from the Sidebar tabs shown by default when you open a new profile with Mozilla 1.4.1. + +
+ +- +Remove any of the Sidebar tabs from the list of tabs available to an end user in the default drop-down list of sidebar tabs available when you open a new profile with Mozilla 1.4.1. (It's OK to add additional tabs). + +
++ +All the changes you make to Sidebar are stored in the
+panels.rdffile, which is located in the directory for the Mozilla profile you were using when you made the changes. For information on the location of Mozilla profiles on different platforms, see Appendix C "Mozilla Profile Locations by Platform." ++ +When you are finished making your changes, put
+panels.rdfin theWorkspace\Sidebardirectory for your configuration (for easy access when you run the CCK tool). ++ + +Specifying the Default Home Page +
+ + ++ +If you wish to change the home page to a URL of your choice, you can do so by typing the URL in the CCK tool screen entitled "Customize the Browser - Part Three." The URL you specify determines both the first page launched and the page users will see when they click the Home button. +
++ + +Preparing Your Customized Bookmarks and Personal Toolbar +
+ + ++ +You can create a complete set of customized bookmarks (URLs that direct users to web pages) for your users. You can also customize the buttons that appear in the Personal Toolbar. Bookmarks and Personal Toolbar buttons are stored together in the Bookmarks menu. +
++ +You can use Personal Toolbar buttons to call attention to value-added services you provide and to make it easy for users to find information you want them to see:
++ +
++ +Note: For new users who are installing Mozilla for the first time, your customized bookmarks remain visible even if the user subsequently upgrades to a later version. However, users who are upgrading from a previous version of Mozilla or Netscape Communicator to the version you are providing will not get your customized bookmarks because, for upgraders, Mozilla preserves their existing set of bookmarks. Therefore, for upgraders, you may want to create a Sidebar tab that includes some of the links you want to make available to customers. For details, see "Creating Your Own Sidebar Tab." +
++ +To customize Navigator's bookmarks, you'll first create a new user profile that contains the default set of bookmarks that come with Mozilla. You'll then modify the default bookmarks list so that it includes your custom bookmarks. +
++ + +Creating a New User Profile +
+ + ++ +To create a new user profile, follow these steps: +
++ +
+- +Quit Mozilla if it is running. + +
+ +- +Open the Start Menu, choose Programs, Mozilla 1.4.1, and then Profile Manager. + +
+ +- +Click Create Profile to create a new user profile. + +
+ +- +Enter a name for the profile, for example, "bookmarks", and click Next. + +
+ +- +Follow the instructions to finish entering profile information. + +
+ +- +When you click Finish, Mozilla starts using the new profile. + +
++ + +Creating Custom Bookmarks and Personal Toolbar Buttons +
+ + ++ +To create a set of custom bookmarks and Personal Toolbar buttons using your new profile: +
++ +
+- +Choose Manage Bookmarks from the Bookmarks menu. A window similar to this appears:
+ +
+ +
+ + +- +Use the Bookmarks window to add, delete, import, and rearrange (drag) bookmarks to produce the set that you want. + +
+ +- +To add an item to the Personal Toolbar, either drag and drop a bookmark onto the Personal Toolbar folder, or highlight the Personal Toolbar folder and use the File menu options to add a new bookmark. Bookmarks you create in the Personal Toolbar folder will appear as buttons on the user's Personal Toolbar. + +
+ +- +To remove an item, highlight the associated bookmark in the Toolbar Folder and press Delete, or go to the Edit menu and select Delete. + +
+ +- +Close the Bookmarks window when you are finished. + +
++ +You can also add a bookmark button to the Personal Toolbar for the page currently displayed in your browser by dragging the bookmark icon (located to the left of URL in the Navigation Toolbar) to a desired place on the Personal Toolbar:
++ +
++ +The pointer changes from an arrow into a hand when it is pointing at the bookmark icon +
++ +Mozilla 1.4.1 creates the customized
+bookmarks.htmlfile in the directory for the profile you were using when you set up your customized bookmarks. For information on the location of Mozilla profiles on different platforms, see Appendix C "Mozilla Profile Locations by Platform." ++ +When you are finished making your changes, put
+bookmarks.htmlin theWorkspace\Bkmksdirectory for your configuration (for easy access when you run the CCK tool). ++ + +Determining Text for the Browser Window's Title Bar +
+ + ++ +You can add your company name to the browser window's title bar, so that your company name appears at the top of every browser window. For example, this illustrates the customized browser window's title bar for a company called MyIsp: +
+ ++ +If you decide you want to customize the browser in this way, you simply specify your company name when the CCK tool displays the screen entitled "Customize the Browser - Part Three." +
++ + +Checklists for Customizing the Browser +
+ + ++ + +Customize the Browser - Part One +
+ + ++ +The screen called Customize the Browser - Part One specifies the following: +
++ +
+- +Animated logo: + +
++ +
+ +- +Logo button URL + +
+- +Path to animated GIF file (stored in
+Workspace\AnimLogo) + +- +Path to "at rest" GIF file (stored in
Workspace\AnimLogo)
+ +- +Help Menu Item: + +
+ ++ + +Customize the Browser - Part Two +
+ + ++ +The screen called Customize the Browser - Part Two specifies the following: +
++ +
+- +Text added to "Mozilla by" in the name of the Mozilla program folder in the Windows Start menu + +
+ +- +Path to custom read-me file (stored at top level of
Workspace) + +
+ +- +Path to custom Sidebar tabs (stored in
Workspace\Sidebar) + +
++ + +Customize the Browser - Part Three +
+ + ++ +The screen called Customize the Browser - Part Three specifies the following: +
+ + +
++ + + + + diff --git a/mozilla/cck/CCKDocs/cd_cck.htm b/mozilla/cck/CCKDocs/cd_cck.htm new file mode 100644 index 00000000000..42c515e0150 --- /dev/null +++ b/mozilla/cck/CCKDocs/cd_cck.htm @@ -0,0 +1,607 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 8 + + + + + +Preparing to Customize the CD Autorun Screen +
+ +The CCK tool screen called Customize the CD Autorun Screen specifies background image and text customizations for the CD autorun screen, which appears automatically when users insert your customized Mozilla CD into a CD-ROM drive. +
++ +This chapter describes the information and files you need to prepare if you want to customize the CD autorun screen. It includes these sections: +
++ +What Is the CD Autorun Screen?
+
Customizing the CD Autorun Screen's Background Image
Customizing Text for the CD Autorun Screen
Customizing the Installation Document
Checklist for Customize the CD Autorun Screen ++ + +What Is the CD Autorun Screen? +
+ + ++ +If you plan to create Mozilla installers for CD distribution, you can provide a CD autorun screen that automatically appears when the user inserts your customized Mozilla CD into a CD-ROM drive. +
++ +The CD autorun screen makes it easy for your users to install Mozilla or to read installation instructions before they begin the installation process. +
++ + +About the Default CD Autorun Screen +
+ + ++ +The CCK tool provides a default CD autorun screen that's ready to use:
++ +
++ + +Customizing the Standard CD Autorun Screen +
+ + ++ +Customizing the standard CD autorun screen is optional. If you wish, you can use the CCK tool to customize the following items in the standard CD autorun screen: +
++ +
+- +The background image that appears in the CD autorun screen + +
+ +- +The text inside and below the screen's title bar + +
+ +- +The contents of the installation text file (
install.txt) + +
++ +Here is an example of a CD autorun screen that was customized by the CCK tool:
++ +
++ +After you create your CD-based installer using the CCK tool, you can make additional manual customizations to the CD autorun screen, such as adding new screens or buttons. For more information, see Chapter 11 "Manually Customizing the CD Autorun Screen" +
++ + +Customizing the CD Autorun Screen's Background Image +
+ + ++ +You can customize the CD autorun screen's background image if you want to add your company logo or add other images that promote your company's identity. +
++ +The standard background image for the CD autorun screen consists of a 640 pixel by 480 pixel bitmap (
+ +.BMP) file, as illustrated here:+ +
++ +The easiest way to customize the background image is to edit the existing background image, called
+install.bmp, as described in the next section. If you prefer, you can substitute your own custom file as described under "Creating Your Own Custom Background Image." ++ + +Editing the Standard Background Image +
+ + ++ +To edit the standard background image: +
++ +
+- +Locate the standard background bitmap file: + +
++
+ +installation_directory\CCKTool\Configs\my_config\Workspace\Autorun\ +Shell\bmps\install.bmp + +++ +where installation_directory is the directory where you installed the CCK tool and my_config is the name of the configuration you are customizing. +
++ +
+- +Using a graphics editing program, open the
isntall.bmpfile and make your changes to it. For example, you might want to add your company's logo and name. + +
++
+ +- +Note: Do not add text or graphics within the black border area at the bottom of the CD autorun screen. This area is reserved for the CD autorun screen's Browse CD, Back, and Exit buttons. +
- +Save your changes, making sure to save the file in
.BMPformat. If you want, you can save the file using another name. + +
+ + +- +Under Background Bitmap, click Choose File and browse to the location of your custom background image to include it. + +
++ + +Creating Your Own Custom Background Image +
+ + ++ +To create your own custom background image for the CD autorun screen: +
++ +
+- +Using a graphics editing program, create a bitmap image that's 640 pixels wide and 480 pixels high. + +
++
+ +- +Keep the size of the file as small as possible (325 Kbytes or less) by reducing the number of colors in the file, or by removing or flattening the layers (if you created the image in Photoshop). If your file size is too large, it may not appear in the CD autorun screen. +
- +At the bottom of the background image, create a rectangular border at least 40 pixels high and 640 pixels wide. The CD autorun screen will use this area to display the CD control buttons (Browse CD, Back, and Exit). + +
+ +- +Save the image as a
.BMP(bitmap) format file here: + +
++
+ +Your background bitmap image is now ready to specify when you run the CCK tool. +
++ + +Customizing Text for the CD Autorun Screen +
+ + ++ +The CCK tool's CD autorun screen specifies two text strings for the CD Autorun Screen: +
++ +
+- +Title bar text. Text that appears in the CD autorun screen's title bar after "Mozilla by". For example, if you enter "My ISP" the title bar text will read "Mozilla by My ISP". + +
+ +- +Text below title bar. Text that appears just below the title bar. For example: "Welcome to the My ISP Installer for Mozilla 1.4.1." + +
++ +You should decide on the exact wording of these strings before you run the CCK tool. +
++ + +Customizing the Installation Document +
+ + ++ +The CD autorun screen includes a button that, when clicked, opens a text document that contains instructions for installing Mozilla. You might want to include additional information in this document that you want your users to know before they install. +
++ +For example, you could add information on your products and services, and tell users how they can contact you for more information. If you're planning to include installers for additional programs as part of your Mozilla installer, this document is a great place to tell your users about the additional programs you're providing. +
++ +To edit the installation document: +
++ +
+- +Locate the standard installation document: + +
+ +- +Make a copy of this file and save here: + +
+ + +- +Edit the
install.txtdocument and save your changes. + +
++ +Your background bitmap image is now ready to specify when you run the CCK tool. +
++ + +Checklist for Customize the CD Autorun Screen +
+ + ++ +The Customize the CD autorun screen specifies the following: +
++ +
+ +- +Background bitmap image (stored as
Workspace\Autorun\Shell\bmps\install.bmp) + +
+ +- +Title bar text + +
++ +
+ +- +text that appears after "Mozilla by" in the title bar + +
+- +text displayed just below the title bar
+ +- +Custom installation text file (stored as
Workspace\Autorun\install.txt) + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/cd_man_cck.htm b/mozilla/cck/CCKDocs/cd_man_cck.htm new file mode 100644 index 00000000000..cbeeac8e42a --- /dev/null +++ b/mozilla/cck/CCKDocs/cd_man_cck.htm @@ -0,0 +1,1899 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 11 + + + + + +Manually Customizing the CD Autorun Screen +
+ +The CD autorun screen automatically appears when a user inserts a customized Mozilla CD into a CD-ROM drive. The standard CD autorun screen lets your users easily install Mozilla or read installation instructions before they begin installation. You can customize some aspects of this screen, such as the title bar text and background, using the CCK tool. +
++ +If you're planning to distribute a Mozilla installer on a CD, you might want to make more customizations to the standard CD autorun screen than the CCK tool can implement. This chapter describes the manual customizations to the CD autorun screen that you can make, if you wish, to the installation files generated by the CCK tool. +
++ +This chapter contains these sections: +
++ +Why Manually Customize the Standard CD Autorun Screen?
+
Run The CCK Tool First
About the CD Autorun Files
Tools for Customizing the Standard Autorun Screen
Creating a CD Staging Area on Your Hard Disk
Understanding the rshell.ini File
Editing the rshell.ini File
Verifying Your CD Autorun Screen Manual Customizations ++ + +Why Manually Customize the Standard CD Autorun Screen? +
+ + ++ +Chapter 8 "Preparing to Customize the CD Autorun Screen" describes the following customizations that you can make to the standard CD autorun screen using the CCK tool: +
++ +
+- +Customize the CD autorun screen's background bitmap image. + +
+ +- +Provide your own title bar text and text below the title bar. + +
+ +- +Customize the contents of the installation guide text file. + +
++ +You can manually customize the standard CD autorun screen if you want to: +
++ +
+- +Create additional screens that inform users about your products, services, and promotions. + +
+ +- +Include additional files or software on the CD. You can add new screens and buttons to the CD autorun screen that give users easy access to the directories on the CD that contain these files, so that users don't have to browse through the directories on the CD to find them. You can also include a button in the CD autorun screen that opens a
readme.txtfile, so users have easy access to information about these additional files. (For information about adding up to two additional installers with the CCK tool, see Chapter 9 "Preparing to Create the Installer." + +
+ +- +Installers for additional applications on the CD. You can add buttons and text to the standard CD autorun screen that inform users about these applications and make them convenient to install. + +
+
+ + ++ +Before manually customizing the standard CD autorun screen, use the CCK tool to create a Mozilla installer that includes the CD autorun screen. Make sure you select the checkbox labeled "Include CD autorun screen" on the Gathering Information screen. Checking this box causes CCK to include the files associated with the CD autorun screen when it creates your customized Mozilla installer. After the CCK tool builds the installer, verify that the CD autorun customizations are correct. +
++ + +About the CD Autorun Files +
+ + ++ +The CD autorun screen is a standard Windows executable program that automatically launches when users insert the CD in a CD-ROM drive. +
++ +When you create your customized Mozilla installer, the CCK tool places the CD Autorun files in this location: +
++
+ +installation_directory\CCKTool\Configs\my_config\Output + +++ +When you are finished editing the CD autorun screen files, you use the contents of the
+Outputdirectory to create your CD layout. ++ +These files and directories are associated with the CD autorun screen: +
++ +
+- +The
Nsetup32.exeprogram (the Autorun program) and thershell.inifile are both located in the directoryOutput\Shell\Nsetup32\. Thershell.inifile contains all of the custom settings and flags that control the appearance and function of the CD autorun screen. + +
+ +- +
setup.exe,launch.ini, andautorun.infare located in theOutputdirectory, which is the root of the CD layout. They control the automatic launch of the Autorun program and the CD autorun screen. Thelaunch.inifile points to the location of theNsetup32.exeautorun program and its associated file,rshell.ini. If the Autorun screen doesn't automatically launch, users can double-click the setup.exe file. + +
++ +In addition to controlling the appearance of the CD autorun screen, the
+rshell.inifile also links any number of CD autorun screens together using buttons. The buttons can also point to any installers or files included on your CD that you want users to be able to access. ++ +For more information about preparing your CD layout, see Chapter 14 "Distributing Your Installers." +
++ + +Tools for Customizing the Standard Autorun Screen +
+ + ++ +To customize the standard autorun screen or add new screens, you'll need: +
++ +
+- +Aa standard text editor for editing the
rshell.inifile. + +
+ +- +A graphics editing program, for creating any custom bitmap images that you want to include as background or button images in the Autorun screens. + +
++ +You can include one or more directories inside the shell directory to store the custom bitmap images used by the autorun screens. Depending on the CD layout you want to create, you can also include directories for additional items such as applications that you want users to be able to install by clicking buttons in the CD autorun screen. +
++ + +Creating a CD Staging Area on Your Hard Disk +
+ + ++ +Before you start editing the
+rshell.inifile, you'll need to determine the directory structure on the CD so that you know how to specify the pathnames of files that you want to be accessible through the Autorun screens. You do this by creating a staging area on your hard disk that exactly represents the final CD layout you intend to use. ++ +To create a CD staging area: +
++ +
+- +Create a directory called Staging on your hard disk. + +
+ +- +Locate the
Outputdirectory you created using the CCK tool. + +
+ +- +Copy the contents of the Output directory into the Staging directory. + +
+ +- +Inside the
Stagingdirectory, create a directory for each additional component that you want to include on the CD. + +
++ +Inside the
+Staging\Shelldirectory, you'll find a directory calledbmpsin which you'll store the custom background bitmap images for any new CD autorun screens you create. ++ + +Understanding the rshell.ini File +
+ + ++ +Note: The
+rshell.inifile does not support the usage of double-byte character sets such as those used in the Chinese, Japanese, and Korean languages. ++ +To understand the structure of the
+rshell.inifile, use a standard text editor such as NotePad to openShell\Nsetup32\rshell.ini, and examine the descriptions contained in the file. ++ +The
+rshell.inifile consists of two sections: ++ +
+- +The [General] section is where you specify the attributes of the control buttons (Browse CD, Back, and Exit) that appear at the bottom of the Autorun screens. + +
+ +- +The [Dialog] sections specify the attributes and behavior of each Autorun screen. Each [Dialog] section defines one Autorun screen, and you name the [Dialog] sections sequentially as [Dialog1], [Dialog2], [Dialog3], and so on, one for each Autorun screen. + +
++ + +General Settings in the rshell.ini File +
+ + ++ +This section describes the general settings in the
+rshell.inifile that apply to all dialogs. ++ + +Text for Browse, Back, and Exit Buttons +
++
+ +browse_button_text=text + +++
+ +back_button_text=text + +++
+ +exit_button_text=text + +++ +Specify the text displayed for the Browse, Back and Exit buttons. The Browse and Exit buttons appear on all dialogs. The Back button only appears if the
+rshell.inifile specifies more than one dialog. ++ +Use an
+ +&(ampersand) in front of the character you want to assign as the keyboard shortcut for this button. For example,browse_button_text=Browse &CDsets C as the keyboard shortcut for this button. ++
+ +browse_button_text=Browse &CD + +++
+ +back_button_text=Back + +++
+ +exit_ button_text=Exit + +++ + +Positions of Browse, Back, and Exit Buttons +
++
+ +browse_button_pos= x1,y1,x2,y2 + +++
+ +back_button_pos= x1,y1,x2,y2 + +++
+ +exit_button_pos= x1,y1,x2,y2 + +++ +Specifies the position of the Browse, Back, and Exit buttons, relative to the top left corner (0,0) of the dialog. If not specified, button position is based on dialog size. +
+ ++ +x1,y1: The upper left coordinates of the button, in pixels, relative to the top left corner of the dialog. +
++ +x2,y2: The lower right coordinates of the button, in pixels, relative to the top left corner of the dialog. These coordinates are ignored if button bitmap files are specified using the
+browse_button_bitmaps,back_button_bitmaps, orexit_button_bitmapssetting. ++ + +Bitmaps for the Browse, Back, and Exit Buttons +
++
+ +browse_button_bitmaps=up.bmp,dn.bmp,sel.bmp,dis.bmp + +++
+ +back_button_bitmaps=up.bmp,dn.bmp,sel.bmp,dis.bmp + +++
+ +exit_button_bitmaps=up.bmp,dn.bmp,sel.bmp,dis.bmp + +++ +Specifies the button bitmaps used for the Browse, Back, and Exit buttons. Four bitmaps specify the four possible states of the button: up, down, selected, disabled. This setting is optional. If you don't specify bitmaps for a button, the dialog uses a standard Windows button with the text specified in
+ +browse_button_text,back_button_text, orexit_button_text. ++ +
+up.bmp: Specifies the bitmap associated with the up (unpressed) button state. ++ +
+dn.bmp: Specifies the bitmap associated with the down (pressed) button state. ++ +
+sel.bmp(optional): Specifies the bitmap associated with the selected (mouse-over) button state. ++ +
+ + + +dis.bmp(optional): Specifies the bitmap associated with the disabled button state. ++ +This section describes the global settings that apply within a dialog. +
+ ++
+ +caption=caption text + +++ +Specifies the text that appears in the dialog's title bar. +
+ ++
+ +dialog_position=x1,y1,x2,y2 + +++ +Specifies the position of the dialog on the monitor screen. If not specified, the dialog is displayed at the center of the monitor screen. If
+ +bk_bitmapis specified, x2,y2 is ignored. ++ +x1,y1: Specifies the coordinates, in pixels, relative to the top left corner (0,0) of the dialog. +
++ +x2,y2: Specifies the coordinates, in pixels, of the lower-right corner of the dialog. +
+ ++
+ +bk_bitmap=background.bmp + +++ +Specifies the background bitmap file used for the dialog. If a background bitmap file is not specified, the dialog uses the system background color for its background color. +
+ ++ +Specifies the vertical gap (y), in pixels, between the buttons in the dialog. +
+ + + ++ +This section describes the settings used for the title text in a dialog. You use these settings to include a line or paragraph of text that can appear anywhere within the dialog. +
+ ++
+ +dialog_title_text=text + +++ +Specifies the title text for the dialog. +
+ ++
+ +dialog_title_pos=x1,y1,x2,y2 + +++ +Specifies the position in pixels, relative to the top left corner of the dialog, of the title text. +
+ ++ +x1,y1: Specifies the position of the top left corner of the text. +
++ +x2,y2: Specifies the position of the bottom right corner of the text. +
++ + +Dialog Title Text Color +
++
+ +dialog_title_text_color=red,green,blue + +++
+ +dialog_title_shadow_color=red,green,blue + +++
+ +dialog_title_shadow_depth=red,green,blue + +++ +Specifies the text color, shadow color, and shadow depth of the dialog title text. You specify a number between 0 (black) and 255 (white) for each of the red, green, and blue values to get the overall pixel color. +
++ +Table 1 lists commonly-used colors from the standard Windows palette.
++ + +Table 11-1 Windows palette colors +
+
++
+ + + + ++ ++ + ++ + + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ ++ ++ + ++ + ++ ++ + ++
+ +dialog_title_text_font=font,size + +++ +Specifies the font and font size used for the dialog's title text. It's best to use a standard font that you know will be available on end users' machines. If not specified, the system font and font size are used. +
++ + +Dialog Title Text Style +
++
+ +dialog_title_font_bold=TRUE/FALSE + +++
+ +dialog_title_font_underline=TRUE/FALSE + +++
+ +dialog_title_font_italic=TRUE/FALSE + +++ +If set to
+TRUE, specifies the font style (bold, italic, underline) used for the dialog's title text. If not specified or if set toFALSE, the style is not applied. ++ + +Global Button Text Settings +
+ + ++ +This section describes the text settings used for all button text in a dialog. +
+ ++ +
+text_color_default=red,green,blue++ +
+text_color_highlight=red,green,blue++ +Specifies the default text color and the mouse-over (highlight) text color of all button text in a dialog. You specify a number between 0 (black) and 255 (white) for each of the red, green, and blue values to get the overall pixel color. The text automatically changes to the mouse-over (highlight) text color when you position the mouse over a button in the dialog. +
++ +Table 11-1 lists commonly used colors from the standard Windows palette. +
++ + +Button Title and Body Text +
++
+ +button_title_text_font=font,size + +++
+ +body_text_font=font,size + +++ +Specifies the font and size used for the dialog's button title text and button body text. It's best to use a standard font that you know will be available on end users' machines. If not specified, the system font and font size are used. +
+ ++
+ +button_title_font_bold=TRUE/FALSE + +++
+ +button_title_font_italic=TRUE/FALSE + +++
+ +button_title_font_underline=TRUE/FALSE + +++ +If set to
+ +TRUE, specifies the font style (bold, italic, underline) used for the dialog's button title text. If not specified or if set toFALSE, the style is not applied. ++
+ +body_text_font_bold=TRUE/FALSE + +++
+ +body_text_font_italic=TRUE/FALSE + +++
+ +body_text_font_underline=TRUE/FALSE + +++ +Specifies the font style (bold, italic, underline) used for the dialog's button body text. If not specified or set to
+FALSE, the style is not applied. ++ + +Column Settings Within a Dialog +
+ + ++ +This section describes the settings used for columns within a dialog. Each dialog can have one or more columns. The settings for the first (left-most) column all begin with col1; the settings for the second column all begin with col2, etc. If you only want one column of buttons in a dialog, delete all of the col2 and greater settings, or you can leave them blank. +
++ + +Position of First Button in Column One +
++
+ +col1_button_pos=x,y + +++ +Specifies the position of the first button in column 1 of a dialog. You specify the x,y coordinates of the upper-left corner of the button, relative to the upper-left corner of the dialog (0,0). If you want, you can specify an offset position for an individual button using the
+button1_offsetsetting described later in this chapter. ++ + +Position of a Button's Descriptive Text +
++
+ +col1_text_offset=offset + +++ +You can use either of these settings to specify the position of the button's descriptive text. Use
+col1_text_offsetif you want to specify the text's position by defining an offset between the button and the button text. Usecol1_text_posxinstead if you want to specify the absolute x position of the button's descriptive text. ++ +If unspecified, the default is
+ +col1_text_offset=10. If both settings are specified,col1_text_offsetis ignored and the absolute x position as specified incol1_text_posxis used. ++ +Specifies the distance x, relative to the left edge of the dialog box, at which the button descriptive text wordwraps to the next line. If this setting is not specified, the text wordwraps when it is 10 pixels to the left of the right edge of the dialog. +
++ + +Button Settings Within a Dialog +
+ + ++ +This section describes the settings used for buttons within a dialog. Each dialog can have one or more buttons. The settings for the first button all begin with button1, the settings for the second button all begin with button2, and so on. If you only want one button in a dialog, delete all of the button2 and greater settings, or leave them blank. +
+ ++ +
+button1_bitmaps= up.bmp,dn.bmp,sel.bmp,dis.bmp++ +Specifies the button bitmaps used for button1. Four bitmaps specify the four possible states of the button: up, down, selected, disabled. This setting is optional. If you don't specify bitmaps for a button, the dialog uses a standard Windows button with the text specified in
+ +button1_text_title. ++ +
+up.bmp: Specifies the bitmap associated with the up (unpressed) button state. ++ +
+dn.bmp: Specifies the bitmap associated with the down (pressed) button state. ++ +
+sel.bmp(optional): Specifies the bitmap associated with the selected (mouse-over) button state. ++ +
+ +dis.bmp(optional): Specifies the bitmap associated with the disabled button state. ++
+ +button1_cmdline=action,target + +++ +Specifies the action you want to assign to the button. Clicking a button can cause one of seven possible actions, depending on the value you specify for the action argument. The possible button actions and arguments are: +
++ +
+ +- +Launch a program (
action=exe) + +
+ + +- +Go to a different dialog screen (
action=window) + +
+ + +- +Open a file (
action=open) + +
++
+ +- +The file opens with whatever program the operating system has associated with the file's type. If a file type association doesn't exist, Windows asks the user to choose a program. +
- +Example:
button1_cmdline=open,..\..\install.txt+
- +Print a file (
action=print) + +
++
+ +- +The file is printed with whatever program the operating system has associated with the file's type. If a file type association doesn't exist, Windows asks the user to choose a program. +
- +Note: You cannot print HTML files through Windows. +
- +Example:
button1_cmdline=print,..\..\install.txt+
- +Explore a directory on the CD (
action=explore) + +
++
+ +- +Opens the specified directory on the CD. The directory path must be specified as an absolute path from the root of the CD. +
- +Example:
button1_cmdline=explore,extras\clipartopens theextras\clipartdirectory, which is at the root level of the CD. +
- +Open a file in the Mozilla Browser (
action=mozilla) + +
++
+ +- +Opens the specified file using the currently-installed version of the Mozilla Browser. The file type can be
.html,.gif,.jpeg, or any other file type that the browser can open, such as
- +Example:
button1_cmdline=mozilla,myfile.html+
- +Create a shortcut on the desktop (
action=desktop) + +
++
+- +When button1 is clicked, a shortcut is created on the desktop, using the specified shortcut name and icon file, that opens the specified file or directory on the CD. File or directory paths must be specified as absolute paths from the root of the CD. +
- +Example:
button1_cmdline=desktop,readme.txt,Read Me,\shell\icons\readme.ico+
- +Button Text +
- +Specifies the button title text and body text for button1. +
+ +Specifies the button's horizontal (x) and vertical (y) offset, in pixels, from the location specified in the
+col1_button_possetting. If there is more than one button in column 1, and you only specify an offset for button1, the other buttons in the same column will use the same vertical (y) offset. You can change the offsets for the other buttons by specifying individual button offsets for each of them. ++ + +Editing the rshell.ini File +
+ + ++ +To edit the rshell.ini file: +
++ +
+ + + +- +Locate the
Staging\Shell\nsetup32\rshell.inifile and open it using a standard text editor. Familiarize yourself with the settings in thershell.inifile. + +
+ +- +Decide how many dialog screens you want to use. If you need more dialog screens than are defined in the
rshell.inifile, copy an entire[Dialogx] section (where x is a unique number associated with each dialog) and paste it as needed into the file. Each dialog screen must have a unique number. If you need fewer than are provided by default, remove entire[Dialogx] sections as necessary. + +
+ +- +Design the layout, background images, buttons, and text for each dialog screen. Make the necessary customizations in the settings in the rshell.ini file. + +
++
+ +- +Note: Rather than entering the text for a screen in the
rshell.inifile, you may prefer to create your text as part of the background image using an image editing program such as Adobe Photoshop. Using an image editing program gives you more control over the appearance of the text, including fonts and colors. +
- +Assign an action to each button in each dialog screen. + +
+ +- +Save your changes to the
rshell.inifile in place; do not move the file. + +
++ +The supplied
+rshell.inifile includes a second dialog, Dialog2, that is not visible by default. To enable it, locate the button3 settings that are commented out with semicolons (located within the section in thershell.inifile called "Buttons 2 - 6 for Dialog 1"). Remove the semicolons in front of all the button3 settings, save your changes, and then launch the Autorun screen by double-clicking the fileShell\nsetup32\Nsetup32.exefile. Click the third button in the first screen (labeled Bonus Applications and Plug-ins) and you'll be able to see the second dialog. ++ +To add a new Autorun screen: +
++ +
+- +Locate the file
Staging\Shell\nsetup32\rshell.inifile and open it using a text editor. + +
+ +- +Copy an entire
[Dialogx]section and paste it into thershell.inifile at the location where you want the new screen to appear. + +
+ +- +Increment the value of x in the
[Dialogx] identifier, so that the[Dialogx] section has a unique number. Each[Dialogx] section must have a unique number associated with it, such as[Dialogx],[Dialogx],[Dialogx]. + +
+ +- +Make the necessary customizations to each
[Dialogx] section. + +
+ +- +Save your changes to the
rshell.inifile in place; do not move the file. + +
++ + +Adding A Background Image to a Dialog Screen +
+ + ++ +If you don't specify a background image for a new screen, the new screen uses the system background color. To add a background image to a new screen, follow these steps: +
++ +
+- +Using a graphic editing program, create a background bitmap that's 640 x 480 pixels, and save it as a
.BMPformat file in theshell\bmps\directory. + +
+ ++ +
+ +- +Keep your bitmap file sizes as small as possible by reducing the number of colors the images use or by removing (flattening) the layers if you created the images in Adobe Photoshop. If your images are too large, you may not be able to see them in the Autorun screen. If you cannot see a background image when you test the Autorun screen, open the image in a paint program and try reducing the number of colors to reduce the image's file size. + +
+- +To prevent palette-swapping when switching between Autorun screens, be sure to use a 256-color palette in each background image you create. + +
+- +Be sure to leave room at the bottom of the background bitmap (about 40 pixels in height, preferably black) for placement of the control buttons (Browse CD, Back, and Exit) specified in the rshell.ini file. + +
+- +Open the rshell.ini file using a text editor. + +
+ +- +Locate the dialog section that you want to customize. + +
+ +- +To the right of the
bk_bitmap= setting, enter the path to the bitmap file, relative to the location of the shell directory. For example: + +
+ +- +Save your changes to the
rshell.inifile in place; do not move the file. + +
++ + +Customizing a Screen's Title Bar Text +
+ + ++ +The title bar appears at the top of every autorun dialog screen. You may want to include your company's name in the title bar or provide other identifying information. For example, this screen shows customized text in a CD autorun screen's title bar:
++ +
++ +To customize a screen's title bar: +
++ +
+- +Open the
rshell.ini fileusing a text editor. + +
+ +- +Locate the
[Dialogx]section that you want to customize. + +
+ +- +To the right of the
caption= setting,enter the text that you want to appear in the screen's title bar. + +
+ + +- +Save your changes to the
rshell.inifile in place; do not move the file. + +
++ + +Adding a New Button to a Screen +
+ + ++ +You can add a button to an autorun screen that performs any of these functions: +
++ +
+- +Launch an executable (
.exe) program. + +
++
+ +- +For example, if you want to include an installer for another application on the CD, you can add a button that users can click to launch the installer. +
- +Go to another screen + +
++
+ +- +For example, if you're creating multiple CD autorun screens, you can add a button that users can click to go to a particular screen. (This is in addition to the standard Browse, Back, and Exit buttons that appear on each autorun screen.) +
- +Open a file + +
++
+ +- +For example, you can add a button that opens a
readme.txtfile so that users can read installation instructions for another application you're providing on the CD. +
- +Print a text file + +
+ + +- +Explore a directory + +
++
+ +- +For example, if you're including a directory of utilities on the CD, you can add a button that opens that directory so that user can view its contents. +
- +Open a file in the Mozilla Browser + +
++
+ +- +For example, if you've provided an HTML or GIF format file on the CD that you want users to view in Navigator, you can add a button that opens the file using an already-installed version of Navigator. +
- +Create a shortcut on the user's desktop + +
+ ++ +To add a new button to an Autorun dialog screen: +
++ +
+- +Open the
rshell.inifile using a text editor. + +
+ +- +Locate the dialog section where you want to add a new button. + +
+ +- +Within the dialog section, locate the section where the buttons for the dialog are defined. Each button group begins with + +
+ + +- +Decide how many buttons you want to appear in the dialog. + +
+ +- +If you need more buttons than are defined by default in the
rshell.inifile, copy and paste new button groups and increment the button number for each new group you add. + +
+ +- +To remove buttons, delete the button groups that are above the number you need, or simply leave their settings blank. + +
+ +- +Assign an action to each button using the
buttonx_cmdline=setting. You can define any one of seven different button actions. See the description of thebuttonx_cmdline=setting earlier in this chapter, or by referring to the comments in the rshell.ini file. + +
++
+ +- +For example, to have button1 go to the dialog2 screen, you would enter: +
- +For example, to have button1 launch a program named Setup.exe, you would enter: +
- +When you have finished defining buttons and button actions, save your changes to the
rshell.inifile. + +
++ + +Verifying Your CD Autorun Screen Manual Customizations +
+ + ++ +After you finish editing the
+ + + +rshell.inifile, you should view your custom Autorun screens so you can verify your customizations. Follow these steps: +
++ + + + + diff --git a/mozilla/cck/CCKDocs/config_cck.htm b/mozilla/cck/CCKDocs/config_cck.htm new file mode 100644 index 00000000000..68d774f2c52 --- /dev/null +++ b/mozilla/cck/CCKDocs/config_cck.htm @@ -0,0 +1,1001 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 3 + + + + + +Using the Configuration Workspace for Customized Files +
+ +As you saw in Chapter 2 "Customizing Mozilla in Ten Minutes," the first screen presented by the CCK tool allows you to select a configuration (or create a new one). Each configuration available to the CCK tool has a corresponding directory where the installer for that configuration resides. +
++ +The configuration directory also includes a Workspace directory. If you need to do create an animated logo or customize bookmarks, the default My Sidebar tabs, the read-me file, and other aspects of Mozilla 1.4.1. that require you to prepare files before running the CCK tool, you can use the Workspace to store your customized files while you work on them. +
++ +This chapter describes the contents of the configuration directory, the files you can customize, and where to store them in the Workspace directory. The chapters that follow summarize how to prepare the information and files relevant to each of the remaining screens presented by the CCK tool. +
++ +This chapter contains these sections: +
++ +Creating a New Installer Configuration
+
The Configuration Directory
Customized Files Checklist
Platform and Configuration Information ++ + +Creating a New Installer Configuration +
+ + ++ +The first screen of the CCK tool includes a drop-down list (near the lower-left corner) that allows you to select a configuration. You can also use this screen to create a new configuration or create a copy of an existing configuration. +
++ +Each configuration name in the drop-down list corresponds to a configuration directory of the same name (described in detail in the section that follows). A configuration directory stores both customized files that you supply for use by the CCK tool and the customized Mozilla 1.4.1 installation files created by the CCK tool. +
++ +The CCK tool applies the customizations you specify to the configuration selected in the first screen. If you are customizing features that require you to prepare custom files in advance, you should prepare and verify those files before you run the tool. +
++ +The rest of this chapter describes the layout of the configuration directory and summarizes the files you must prepare for various customizations. The chapters that follow describe how to prepare the customized files for the customizations you can specify with the CCK tool. +
++ + +The Configuration Directory +
+ + ++ +Each configuration name listed in the drop-down list on the first screen of the CCK tool corresponds to a directory name in this location: +
++ +After you run the CCK tool for a given configuration, the corresponding configuration directory contains the following subdirectories and files (assuming the configuration includes a CD autorun screen as well as a network installer): +
++ +
+- +
Outputcontains all customized installation files: + +
++ +
+ +- +
+Core+ +- +
+Shell+ +- +
+autorun.inf+ +- +
+install.txt+ +- +
+launch.ini+ +- +
setup.exe
+ +- +
Workspaceincludes the following subdirectories for storing your customized files: + +
++ +
+- +
+AnimLogostores the .GIF files associated with the animated logo button. See Customizing the Mozilla Browser for the instructions to create these files. + +- +
+Autorunstores a custom background image for the CD autorun screen. See Customizing the CD Autorun Screen for the instructions to create the custom files. + +- +
+Bkmarksstores a custom bookmarks file for the Navigator browser. See Customizing the Mozilla Browser for the instructions to create this file. + +- +
+CustInststores additional installers (in the form of self-extracting executable files) that will run after the main installation completes. See Creating Mozilla Installers for more information about providing additional installers. + +- +
Sidebarstores a custompanels.rdffile, which contains the sidebar information used by the browser. See Customizing the Mozilla Browser for instructions on modifying the default panels.rdf file. + ++ +In the default and sample MyISP configurations,
+license.txtandreadme.txt(the Mozilla license and read-me files) are located in theOutputdirectory. In all other configurations, these two files are located one level higher (in the my_config directory). ++ + +Customized Files Checklist +
+ + ++ +Table 3-1 lists the customizations that require customized files and where to find information about preparing those files. +
++ + +Table 3-1 Mozilla 1.4.1 customized file checklist + +
+ +
++
+ + + ++ ++ + ++ + ++ + ++ + + ++ ++ ++ ++ +Animated and at-rest GIF files (32 x 32) for the animated logo +
+ ++ + ++ +Chapter 5 "Preparing to Customize the Mozilla Browser"page 67 +
+ ++ ++ ++ ++ + ++ +Chapter 5 "Preparing to Customize the Mozilla Browser"page 67 +
+ ++ ++ +Custom background graphic for CD autorun screen (for CD-based installers) +
+ ++ +640 x 480 bitmap file containing your custom background image +
+ ++ + ++ +Chapter 8 "Preparing to Customize the CD Autorun Screen" +
+ ++ ++ ++ ++ + ++ +Chapter 8 "Preparing to Customize the CD Autorun Screen" +
+ ++ ++ ++ +The
setup.exefor each additional installer (up to two) ++ ++ + ++ ++ ++ ++ ++ + ++ +Chapter 5 "Preparing to Customize the Mozilla Browser"page 67 +
+ + ++ ++ ++ ++ + ++ +Chapter 5 "Preparing to Customize the Mozilla Browser"page 67 +
+ + +Platform and Configuration Information +
+ + ++ +Table 3-2 summarizes the Mozilla 1.4.1 customizations you can make with the CCK tool and the platforms on which they are supported. +
++ + +Table 3-2 Summary of CCK tool customizations + +
+ +
++
+ + + + + ++ ++ + ++ + ++ + ++ + + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ + ++ + ++ ++ ++ ++ + +
++ + + + + diff --git a/mozilla/cck/CCKDocs/cust_ten_cck.htm b/mozilla/cck/CCKDocs/cust_ten_cck.htm new file mode 100644 index 00000000000..4a91700e728 --- /dev/null +++ b/mozilla/cck/CCKDocs/cust_ten_cck.htm @@ -0,0 +1,647 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 2 + + + + + +Customizing Mozilla in Ten Minutes +
+ +This chapter shows you how to use the CCK tool to implement some of the simplest customizations—that is, those that don't require you to prepare any files beforehand. +
++ +Other customizations that you can perform with the CCK tool, such as providing your own custom bookmarks or custom animated logo, require that you create customized files before you run the tool. Later chapters describe the preparations required for those customizations. +
++ +This chapter contains these sections: +
++ +What You'll Customize
+
Quick Customization Instructions
Verifying Your Customizations +
+ + ++ +This chapter describers how to create a CD-based Mozilla installer for use on Windows that includes these customizations: +
++ +
+- +Your company name displayed in these locations: + +
++ +
+ +- +Browser window's title bar. + +
+- +CD autorun screen, which is the screen that users see when they insert the Mozilla CD into a CD-ROM drive. + +
+- +Mozilla program folder name that appears in the Windows Start menu.
+ +- +The browser's default home page set to your own home page. The home page is the first page users see when they start Navigator and the page they see when they click the Navigator Home button. + +
+ +- +Mail and News server settings. + +
+ +- +A Mozilla installer that installs only the components you want users to have. + +
++ +If these are the only customizations you need to make, your installer will be ready for packaging and distribution after you finish this chapter. +
++ +Even if you plan to make some of the additional customizations that require preparing files, it's still a good idea to follow the steps described in this chapter as a way of familiarizing yourself with the CCK Tool. Once you have prepared the additional files you need, you can run the tool again to add those customizations to the ones you make in this chapter. +
++ + +Quick Customization Instructions +
+ + ++ +This section guides you through the process of running the CCK tool, which is basically the same whether you are performing the simple customizations described here or those requiring some file preparation as described in the chapters that follow. +
++ +The examples shown in this section are based on the sample configuration provided with the tool for a hypothetical ISP called MyISP. You should, of course, enter the equivalent information for your own company in each screen. +
++ +The steps that follow describe how to create a customized Mozilla installer that implements the simple customizations described in the previous section. +
++ +
+- +Open the Start menu and choose Programs, then Mozilla Client Customization Kit, then N6CCKTool. + +
+ +- +Welcome to the Mozilla Client Customization Kit! On the first screen you see when you run the CCK Tool, click New Configuration, enter a name for the directory that the CCK tool will use to store your custom configuration information, and click Create New Configuration. Then click Next to continue.
+ +
+ +
+ +- +Specify Platform Information. You can choose to generate a Windows or a Linux installer. It's also possible to create a Macintosh installer by manipulating the installation files produced for a Windows installer. + +
+ + +- +Gathering Information. This screen specifies whether you want a CD-ready installer, the FTP address (if any) you plan to use for a network-ready installer, and the company identifier that will appear as part of the user agent string.
+ +
+ +
++ +
+- +Confirm that the checkbox labeled "Include CD Autorun Screen" is selected. + +
+- +Enter your company identifier in the field for that purpose near the bottom of the screen
+ ++
+ +- +The company identifier you enter will be included as part of the user agent string, which helps identify the browser type each the browser accesses your web site or any other web site. Your identifier in the user agent string allows your company (or others) to track the number of times Internet web sites are accessed by web browsers that you've customized. +
- +The identifier you supply can be up to 10 characters in length. You must supply one. +
- +For example, if you enter "MyISP" in the Company Identifier field, the resulting user agent string would look like this: +
- +When you are ready, click Next to register the customizations you've made on this screen and proceed to the next screen. +
- +Customize the Mozilla Browser - Part One. This screen allows you to customize the animated logo near the upper-right corner of the Navigator window and to add a Help menu item.
+ +
+ +
++
+ +- +For now, you won't be performing these customizations—but you can come back and do them later if you wish. Just click Next to proceed to the next screen. +
- +Customize the Mozilla Browser - Part Two. This screen specifies the program folder name that appears under Start Menu/Programs, a custom read-me file, and the files to use for a custom animated logo.
+ +
+ +
+ + +- +Customize the Mozilla Browser - Part Three. This screen specifies the default home page, bookmarks file, and title bar text.
+ +
+ +
++ +
+ + +- +Under Default Home Page, enter the URL for the web page that you want to assign as Navigator's default home page. + +
+- +Under Browser Window's Title Bar Text, enter your company name.
+ +- +Customize Mozilla Mail. This screen specifies your mail domain and server information.
+ +
If you choose to provide customized mail settings, fill in every field in the Customize Mozilla Mail screen. You must fill in all fields, otherwise no customized mail server settings will appear in your customized version of Mozilla 1.4.1. + +
++
+ +- +For short descriptions of the information to enter in each field, click the Help button. For examples of the settings that each field controls, click the corresponding Show Example buttons. Click Next when you are finished. +
- +
- +Customize Mozilla News. This screen specifies your mail domain and server information.
+ +
+ +
++
+ +- +If you choose to provide customized news settings, fill in every field in the Customize Mozilla News screen. You must fill in all fields, otherwise no customized news server settings will appear in your customized version of Mozilla 1.4.1. +
- +For short descriptions of the information to enter in each field, click the Help button. For examples of the settings that each field controls, click the corresponding Show Example buttons. Click Next when you are finished. +
- +
- +Customize Proxy Configurations. This screen specifies the default proxy configurations that appear under the Advanced category when the user chooses Preferences from the Edit menu.
+ +
+ +
+ + +- +Customize the CD Autorun Screen. This screen specifies the background, title bar text, and installation text file for the CD autorun screen that appears when a user inserts the CD with your custom installer on it.
+ +
Under Title Bar Text, enter your company name as you want it to appear in the screen's title bar and in the area below the title bar of the CD autorun screen. Then click Next to continue. + +
+ +- +Create the Installer. This screen specifies which Mozilla 1.4.1 components you want to install and up to two additional installers to include with the Mozilla 1.4.1 installer.
+ +
+ +
++
+ +- +Deselect any components in the list on the left that you don't want to include in your installer. +
- +Before building the installer, click To confirm the settings you have selected, click Show Config Info to confirm all the settings you've made to your configuration. If you see any errors, click the Back button repeatedly to return to the screen where the error occurred. After you've corrected any errors, click the Next button for each screen until you see the Create the Installer screen again. +
- +If you are sure all your settings are correct, click Build Installer to create your customized Mozilla 1.4.1 installer. +
- +When the CCK tool informs you that your installer has been created, click OK. The CCK tool creates your installer files in this location (where installation_directory is the directory where you installed the CCK tool and my_config is the directory name you specified in the first screen): + +
++ + +Verifying Your Customizations +
+ + ++ +Once you've created a customized Mozilla installer, you should install your customized software in the same way your users will, so you can verify that all your customizations appear exactly as you intended. Follow these steps: +
++ +
+- +Go to the directory that contains your customized installer and its associated files: + +
+ +- +Double-click the file
setup.exe. This causes the CD autorun screen to appear—the same screen your users will see when they insert the CD that contains your customized Mozilla installer. + +
+ +- +Examine the CD autorun screen to verify that it includes your company name in the title bar and in the area below the title bar. + +
+ +- +Click Install Mozilla 1.4.1 to launch the installer. Choose the Custom installation path so you can verify that the components installed by default are the same ones that you selected using the CCK tool. + +
+ +- +Choose About Mozilla 1.4.1 from the Help menu and verify your customized user agent string, which should appear near the top of the window. For example: + +
+ +- +Verify that the Mozilla program folder name in the Windows Start/Programs menu includes your company name. + +
+ +- +Click the Home button in the Navigator browser to verify that it takes you to the URL you specified, and check the browser window title bar to verify that it includes your company name. + +
+ +- +Verify that the Mail and News account settings are correct. + +
++ +That's all there is to it. If these are the only customizations you want to make, you're ready to begin preparing for distribution: +
++ +
+ + +- +If you want to create a Linux or Macintosh installer, see Chapter 4 "Preparing Platform and Installer Information." + +
+ +- +If you want to create a Macintosh installer, you should also see Chapter 13 "Preparing Macintosh Installers and Program Files." + +
+ +- +When you are ready to distribute your installers, see Chapter 14 "Distributing Your Installers." + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/distribute_cck.htm b/mozilla/cck/CCKDocs/distribute_cck.htm new file mode 100644 index 00000000000..5806438d4f5 --- /dev/null +++ b/mozilla/cck/CCKDocs/distribute_cck.htm @@ -0,0 +1,962 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 14 + + + + + +Distributing Your Installers +
+ +Once you have generated and tested your customized installers, you need to prepare them for distribution. This chapter summarizes some of the major tasks involved. +
++ +This chapter contains these sections: +
++ +Distributing a CD-Based Installer
+
Distributing Network-Downloadable Installers or Binaries ++ + +Distributing a CD-Based Installer +
+ + ++ +The general process for distributing Mozilla installers on CDs works like this: +
++ +
+- +Verify your CD layout. + +
+ +- +Create the CD master disc. + +
+ +- +Verify and virus check the CD master disc. + +
+ +- +Create an archive copy of the CD master disc. + +
+ +- +Deliver CD master disc for duplication. + +
+ +- +Distribute CDs. + +
++ +The sections that follow describe how to verify your CD layout and prepare your files for CD distribution. +
+ ++ + +Verifying Your CD Layout (No Autorun Screen) +
+ + ++ +If you didn't include a CD autorun screen, verify the files for your CD layout as described below. +
+ ++ +Verify your CD layout for Windows as follows: +
++ +
+ +- +Open the directory + +
+ ++ +
+ +- +A file called
+Setup.exe, which is the Mozilla installer file. + +- +A set of
+.xpifiles, which contain the Mozilla component files in archive format. + +- +
autorun.inf, which automatically launches the Mozilla installersetup.exefile when the user inserts the Mozilla CD into a CD-ROM drive.
+ +- +Remove the file called
Setup.exe, since it's not needed. Users will double-click thesetup.exeinstaller file to begin installation. + +
+ +- +Go to "Preparing Your CD-Ready Files for CD Distribution,", later in this chapter. + +
++ +For Macintosh, you need to verify the contents of the Mozilla Full Installer folder that you modified as described above under Building Macintosh Installers. It should contain the following files and directories: +
++ +
+- +Mozilla Installer + +
+ +- +Mozilla read-me file + +
+ +- +License + +
+ +- +Installer Modules (folder that includes
config.ini,installer.ini, and all the.xpifiles) + +
++ +After confirming that these files and directories, go to "Preparing Your CD-Ready Files for CD Distribution." +
+ ++ +After you run the CCK tool to create a Linux installer, decompress the Linux tar file located in this directory: +
++ +The decompressed files should look like this: +
++ +
+- +
xpidirectory + +
+ +- +
config.ini+ +
+ +- +
installer.ini+ +
+ +- +
license.txt+ +
+ +- +
mozilla-installer+ +
+ +- +
mozilla-installer-bin+ +
+ +- +
README+ +
++ +After confirming that these files and directories, go to "Preparing Your CD-Ready Files for CD Distribution." +
++ + +Assembling Your CD Layout (Autorun Screen) +
+ + ++ +If you included a CD autorun screen for your Windows installer, assemble the files for your CD layout as follows: +
++ +
+- +Open the directory + +
+ ++ +
+ + +- +A directory called
+Core, which contains the customized Mozilla files + +- +A directory called
+Shell, containing the subdirectories\Bmpsand\Nsetup32, which include the files for the CD autorun screen + +- +
+Autorun.inf(launches thesetup.exeat the root of the CD image after the CD is inserted in the drive) + +- +
+Launch.ini(configuressetup.exeand detects Windows operating system) + +- +
setup.exe (launches nsetup32.exe, which displays the first Autorun screen)
+ +- +Verify that the
Shelldirectory contains these files and folders: + +
++ +
+ +- +A folder called
+\Bmps, which contains all the standard and customized bitmap (.bmp) files used by the CD autorun screens + +- +A folder called
\Nsetup32, which contains the following: + ++ +
+- +
+Nsetup32.exe, the autorun program + +- +
rshell.ini, the file that defines the appearance and behavior of the Autorun screens. See Chapter 11 "Manually Customizing the CD Autorun Screen" for information on how to manually customize this file.
+ +- +If you've manually customized the CD autorun screen so that users can install additional plug-ins or applications from the Autorun screens, create a directory called
Xinstallinside the directory + +
++
+ +- +Buttons you add to your CD autorun screens can be linked to the executable files you include in the
Xinstalldirectory, so that users can install additional software simply by clicking a button. +
- +Put the additional installers into subdirectories inside the directory + +
++
+ +- +Important: Make sure that the actual locations of the additional installers match the file pathnames you specified for them in the
rshell.inifile. +
- +If you've manually customized the CD autorun screen to open any other files, such as a
readme.txtfile, include the additional files inside the directory + +
+ ++ + +Preparing Your CD-Ready Files for CD Distribution +
+ + ++ +To prepare your CD-ready files for CD distribution, you need the following: +
++ +
+- +Software to create a data CD, such as Adaptec Easy CD Creator or Adaptec Toast + +
+ +- +CD recorder, for creating your master CD + +
+ +- +CD-recordable discs, available where you purchased your CD recorder + +
+ +- +Bit-compare program such as Microsoft's WinDiff utility + +
+ +- +virus checker program + +
+ +- +CD duplication service, to make copies of your master CD + +
++ +Follow these steps to create a master CD disc: +
++ +
+- +If you didn't include a CD Autorun Screen, verify the files in your CD layout as described in Verifying Your CD Layout (No Autorun Screen). If you included a CD autorun screen, assemble the files for your CD layout as described in Assembling Your CD Layout (Autorun Screen). + +
+ +- +Using your CD creation software, create a CD master disc that contains all the files from the directory + +
++
+ +- +If you are creating a hybrid CD that includes a Macintosh partition, you also need to specify the location of the Mozilla Full Installer folder that you modified as described in Chapter 13 "Preparing Macintosh Installers and Program Files". +
- +If you are creating a hybrid CD that includes a Linux partition, you also need to specify the location of the Linux installation files that you decompressed from the Linux tar file produced by the CCK tool. +
- +Using a bit-compare utility such as Microsoft WinDiff, verify that the files on the CD exactly match the files in the \Output directory on your hard disk. + +
++
+ +- +If the files don't compare exactly, make sure you're comparing the correct set of files on your hard disk with the files on the master CD. The most common reason bit comparisons fail is that the wrong set of files are being compared. +
- +Using a virus checker program, verify that the files on the CD are virus free. + +
+ + +- +Create a second gold master disc and keep it in a safe place for archive purposes. + +
+ +- +Provide your gold master disc to a CD duplication service. + +
++
+ +- +Before the duplication service completes your entire order, be sure to request that the duplication service sends you the first several CDs, so you can verify that the contents of these CDs exactly matches your gold master archive CD. Alternatively, you can request that the duplication service performs this step. +
- +Distribute the CDs to your customers. + +
++ +Depending on how you plan to distribute your CDs, you may want to create a printed cover that can be inserted into the CD's plastic jewel case (the plastic case that contains the CD). Your duplication service may offer this service to you. Alternatively, programs such as Adaptec Easy CD Creator include a template for creating printed jewel case inserts. +
++ + +Distributing Network-Downloadable Installers or Binaries +
+ + ++ +To distribute Mozilla 1.4.1 over the network: +
++ +
+- +On your FTP site, create a Mozilla download directory that corresponds to: + +
++ +
+ +- +For Windows and Mac OS 9 (stub installers): the location you entered for the FTP directory in the CCK tool.This is the directory you'll use to store the Mozilla installer files. + +
+- +For Linux (fat installer): the location where you plan to put the Linux tar file produced by the CCK tool. + +
+- +For Mac OS X (customized binaries): the location where you plan to put the compressed Mac OS X files you modified using your customized Windows installation files.
+ +- +If you are preparing a Windows installer, copy the contents of the directory + +
++
+ +- +into the download directory on your FTP or HTTP site. +
- +If you are providing a Macintosh installer (Mac OS 9) or binaries (Mac OS X) for network download, you also need to copy the self-extracting archive that you created as described in Chapter 14 "Distributing Your Installers". +
- +If you are providing a Linux tar file for network download, you need to copy the Linux tar file from the
Outputdirectory. +
- +If you are preparing a Windows installer, put the
Setup.exefile for your Windows installer one level above the download directory. For example, if the download directory isMozilla/download, put theSetup.exefile in theMozilladirectory. + +
++ +In addition to setting up the download directory, you should provide instructions on your web site for each type of installer available. +
++ + +End-User Instructions for Windows +
+ + ++ +Instruct your Windows users to follow these steps: +
++ +
+- +Create a new folder on their hard disk. + +
+ +- +Download the
Setup.exeto that new folder from the FTP location provided by the ISP. + +
+ +- +Double-click the
Setup.exeto install Mozilla 1.4.1. + +
+ +- +Delete the new folder when installation is complete. + +
++ + +End-User Instructions for Macintosh +
+ + ++ +If you are providing a Macintosh Mac OS 9 installer for network download, instruct your Macintosh users to follow these steps to install Mozilla: +
++ +
+- +Download the self-extracting archive from the FTP location provided by the ISP. + +
+ +- +After the file downloads and extracts itself into the Mozilla Full Installer directory, double-click the Mozilla Installer file to install Mozilla. + +
++ +If you are providing a Macintosh Mac OS X binary for network download, instruct your Macintosh users to follow these steps to install Mozilla: +
++ +
+- +Download the self-extracting archive from the FTP location provided by the ISP. + +
+ +- +After the file downloads and extracts itself, double-click the file Mozilla Installer file to run Mozilla. + +
++ + +End-User Instructions for Linux +
+ + ++ +If you are providing a Linux binary for network download, instruct your Linux users to follow these steps: +
++ +
+ +- +Download the Linux tar file from the FTP location provided by the ISP. + +
+ +- +Untar the tar file. + +
+ +- +Go to the directory
mozilla-installer. + +
+ +- +Run
./mozilla-installerto install Mozilla. + +
+ +- +Delete the
mozilla-installerdirectory when installation is complete. + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/gifs/button.gif b/mozilla/cck/CCKDocs/gifs/button.gif new file mode 100644 index 00000000000..33435328567 Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/button.gif differ diff --git a/mozilla/cck/CCKDocs/gifs/cdsteps.gif b/mozilla/cck/CCKDocs/gifs/cdsteps.gif new file mode 100644 index 00000000000..eae0a9aef5a Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/cdsteps.gif differ diff --git a/mozilla/cck/CCKDocs/gifs/myconfig.gif b/mozilla/cck/CCKDocs/gifs/myconfig.gif new file mode 100644 index 00000000000..5b835d9db9b Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/myconfig.gif differ diff --git a/mozilla/cck/CCKDocs/gifs/myisp.gif b/mozilla/cck/CCKDocs/gifs/myisp.gif new file mode 100644 index 00000000000..1a04a168eb7 Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/myisp.gif differ diff --git a/mozilla/cck/CCKDocs/gifs/overview.gif b/mozilla/cck/CCKDocs/gifs/overview.gif new file mode 100644 index 00000000000..7cb43e95f08 Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/overview.gif differ diff --git a/mozilla/cck/CCKDocs/gifs/shell1.gif b/mozilla/cck/CCKDocs/gifs/shell1.gif new file mode 100644 index 00000000000..f6e2e3b6110 Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/shell1.gif differ diff --git a/mozilla/cck/CCKDocs/gifs/zipit1.gif b/mozilla/cck/CCKDocs/gifs/zipit1.gif new file mode 100644 index 00000000000..3dda4e1dca0 Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/zipit1.gif differ diff --git a/mozilla/cck/CCKDocs/gifs/zipit2.gif b/mozilla/cck/CCKDocs/gifs/zipit2.gif new file mode 100644 index 00000000000..2efa2a3f3d1 Binary files /dev/null and b/mozilla/cck/CCKDocs/gifs/zipit2.gif differ diff --git a/mozilla/cck/CCKDocs/gtstd_cck.htm b/mozilla/cck/CCKDocs/gtstd_cck.htm new file mode 100644 index 00000000000..66882b9d625 --- /dev/null +++ b/mozilla/cck/CCKDocs/gtstd_cck.htm @@ -0,0 +1,1500 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 1 + + + + + +Getting Started +
+ +This chapter provides an overview of the customization and distribution process, a brief introduction to the kinds of customizations you can make with the Client Customization Kit (CCK), and a few simple guidelines for using the CCK Tool. +
+ ++ +This chapter contains these sections: +
++ +Why Customize and Distribute Mozilla?
+
Overview of the Customization and Distribution Process
System Requirements
Platform Support
Installing the Client Customization Kit Tool
What Customizations Can I Make?
Which Customizations Can I Make Quickly?
Using the CCK Tool ++ + +Why Customize and Distribute Mozilla? +
+ + ++ +The Mozilla browser is the most customizable browser available today. By customizing Mozilla to match your business requirements, you can drive more traffic to your web site, increase revenue, and reduce development and support. Combined with the loyal Mozilla customer base and strong brand acceptance, the ability to tailor Mozilla to your needs makes it stand out as a powerful business asset compared to other browsers. +
++ +Mozilla 1.4.1 can help you +
++ +
+- +Increase Revenue. Increase customer loyalty by inserting your branding into every component of Mozilla 1.4.1 (browser, Mail, chat client, and more). + +
++
+ +- +Increase traffic to your site by customizing bookmarks and other links in the browser interface. Include your own tabs in My Sidebar to give your customers even more prominent and persistent access to your revenue-generating content and services. +
- +Decrease Costs. Reduce support costs by integrating online support. By customizing My Sidebar, the Personal Toolbar and the Help menu, you can drive your customers to your online support and away from costly phone calls. In addition, Mozilla 1.4.1 has demonstrated superior performance and stability, especially for low-bandwidth customers. + +
+ + +- +Attract Customers. The Mozilla brand can differentiate your product. With over X million current users and a well respected brand throughout the industry, Mozilla can make the decisive difference between you and your competitors. Mozilla's unusually loyal customer base makes this particularly true. + +
+ ++ + +Why Do Users Prefer Mozilla 1.4.1? +
+ + ++ +While many people are loyal to the Mozilla brand, others choose it because of the product benefits. Mozilla 1.4.1 lets them do more online and exercise fine-grained control over their online experience. It also delivers greatly enhanced performance and stability: +
++ +
+- +Efficiency in completing tasks. Mozilla 1.4.1 has been designed with efficiency in mind, to reduce the number of steps—and time—it takes to get things done on the Web. + +
++
+ +- +Features include integrated Search to help you find what you need in fewer steps; Quick Launch to dramatically reduce start-up time; a download dialog to prevent you from losing files; Form Manager to complete long web forms in just two clicks; Email Address Collection so you will never lose an email address again; and integrated Instant Messaging for immediate access to your online buddies. +
- +More choice. Choice is particularly important to people who use the Web frequently. They want the power to choose how they work online and what their online environment is like. + +
++
+ +- +Mozilla let's you choose which tabs to include in Sidebar (choose among hundreds or create your own), set default mail and news server settings, (including IMAP and POP accounts like Yahoo), and even modify the user interface (customize bookmarks and the Personal Toolbar or add a Help menu item). +
- +Safety with more control. If you are concerned about safety, you want to be able to control your environment. Mozilla 1.4.1 delivers more control over the privacy and security of your Internet experience than any other browser. + +
++
+- +The Cookie Manager lets you review the cookies you have and easily reject all cookies, past and future, from web sites you do not trust. The Password Manager can conveniently remember your various passwords for different sites, and you can set a Master Password to encrypt that information and other data so you can safely share your computer with family and co-workers. +
+ +To learn more about Mozilla 1.4.1, see
+http://www.mozilla.ort/releases. ++ + +Overview of the Customization and Distribution Process +
+ + ++ +Here's an overview of the ten main steps you'll follow to customize and distribute your own version of Mozilla 1.4.1: +
++ +
+- +Set up your ISP. If you are setting up your ISP business, you must first do the necessary business and financial planning; set up your servers, Internet access, and other physical infrastructure; and plan for post-distribution customer support. For sources of information on these topics, see Appendix A "Resources for ISPs." + +
+ + +- +Decide which customization strategy you want to pursue. You have three choices: + +
++ +
+ +- +Distribute Mozilla 1.4.1 without making any customizations. If you choose this option, you can skip to Step 9 below. + +
+- +Customize and distribute Mozilla 1.4.1 yourself by following the remaining steps in this section. + +
+- +Use the CCK tool to make the simplest customizations. Follow these steps: + +
++ +
+ +- +Download and install the Client Customization Kit + +
+- +Review the rest of this chapter and make sure your available hardware and software meets the system requirements. + +
+- +Follow the instructions in Chapter 2 "Customizing Mozilla in Ten Minutes" for making the simplest customizations. Even if you want to make some of the more complex customizations described in the rest of this document, this chapter can help you get acquainted with the CCK tool quickly. + +
+- +Based on the information in this chapter and Chapter 2, determine what customizations you want to make and which platforms you want to create installers for. + +
+- +If the customizations you want to make are limited to the simple ones described in Chapter 2, you can skip to Chapter 12 or Chapter 13 (see Step 9 below).
+ +- +Use the CCK Tool to make more advanced customizations. Follow these steps: + +
++ +
+ +- +If you need more information about any CCK tool screen or if you wish to use the CCK tool to make additional customizations that require some file preparation, read the relevant parts of Chapters 3 through 9. + +
+- +Prepare your customized files, if any. Use the checklists in this chapter to decide which custom files you need to create. Chapters 5 through 8 provide detailed instructions on specific file customizations. + +
+
+ +- +Note that some customizations don't require you to create a customized file first. For example, to change Navigator's default home page or include your company name in the CD autorun screen, you simply enter this information directly into the tool and let the tool do the rest. See Table 1-1 for a list of quick customizations that you can enter directly into the CCK tool. +
- +Start the CCK tool and create a new configuration for the installer you want to create first. Depending on how many installers you want to create and which platforms you want to support, you may have to run the CCK more than once and you may have to create more than one configuration. + +
+
+ +- +For more information about configurations and installers, see Chapter 3 "Using the Configuration Workspace for Customized Files" and Chapter 4 "Preparing Platform and Installer Information." +
- +Run the rest of the CCK tool. + +
+- +Build and test your installer. + +
++ +
+ +- +On the CCK tool's last screen, click Build Installer to create your Mozilla installer. + +
+- +Run your custom installer and verify that all your customizations made with the CCK tool have taken effect correctly. For detailed instructions, see Chapter 10 "Verifying Your CCK Tool Customizations." If you find any errors, fix the customized files involved (if necessary) and run the CCK tool again to regenerate the installer.
+ +- +Make additional manual customizations. These can include advanced customizations for the CD autorun screen, turning of Mozilla activation, and other tasks that require direct manipulation of the installation files. For detailed instructions, see Chapter 11 "Manually Customizing the CD Autorun Screen" and Chapter 12 "Advanced Mozilla Customizations." + +
+ +- +Test your manual customizations. Run your custom installer, verify that all your manual customizations to have taken effect correctly, and if necessary fix any customizations that have not taken effect. + +
++
+ +- +Important: If you make any manual customizations, do not run the CCK tool again for the same configuration, or it will overwrite all your manual customizations. +
- +Prepare for distribution. Follow these steps: + +
++ +
+ +- +If you want to distribute a customized Macintosh installer, follow the instructions in Chapter 13 "Preparing Macintosh Installers and Program Files." + +
+- +Assemble your CD layout or make your network installer available on your FTP site for download. + +
+
+ +- +If you're providing a CD-based installer, assemble a CD layout that consists of your Mozilla installer, related Mozilla installation files, and any other files you want to include on the CD. +
- +If you're providing a network-downloadable installer, copy the installer and its associated files to your network's FTP server and provide users with instructions on how to download and run the installer. +
- +Chapter 14 "Distributing Your Installers" describes how to prepare your customized installation files for CD and/or online distribution. +
- +If you've created a CD-based installer, prepare it for distribution to your customers.
+ +- +Distribute Mozilla and provide appropriate information to your customers regarding installation, initial account setup, and customer support. The steps a customer follows after receiving the a CD from an ISP typically go something like this: + +
++ +
+- +Installs software (including but not necessarily limited to Mozilla 1.4.1), either from a CD or over the network, according to instructions provided by the ISP. + +
+- +Configures system and browser software for the new account. + +
+
+ +- +Account setup can be done manually or automatically (with the aid of software provided by the ISP). Typically, it involves configuring dialer and modem software, TCP/IP settings, and Mozilla 1.4.1 settings such as email address according to information provided by the ISP. +
- +Connects with the ISP, logs in, and begins using the service.
+ ++
+- +Details of end-user instructions for installation and account setup vary widely among ISPs. To get you started: +
+ +
+- +"Distributing Network-Downloadable Installers or Binaries" includes end-user network installation instructions for Windows, Macintosh, and Linux. + +
+- +Appendix B "Manual Account Setup summarizes the minimum information your customers need to set up their own accounts for your ISP business. + +
+ + + + + ++ +To create a Windows installer with the CCK tool, you need a system that meets these requirements: +
++ +
+- +An IBM-compatible computer running Windows NT 4.0, Windows 2000, or Windows XP. + +
+ +- +Pentium 233 MHz (or faster) processor + +
+ +- +64 MB of RAM (or greater) + +
+ +- +At least 65 MB hard disk space for installation + +
+ +- +At least 50 MB hard disk space for target and temporary files created by CCK + +
++ +If you are creating a Linux installer, your Windows system must also meet these requirements: +
++ +
+- +The GNU Tools for Microsoft Windows (the Cygnus toolkit) must be installed. You can obtain the Cygnus toolkit from + +
++
+
+ +http://www.cygwin.com/+
+ + +- +The volume on which you install the CCK tool must have at least 108 MB of hard disk space in addition to the space described above, for these purposes: + +
+ ++ +If you are creating a Linux installer, you must download the standard Mozilla 1.4.1 Linux tar file from
+http://ftp.mozilla.orgto some convenient location before you run the CCK tool. (The standard Linux installation files are not included in the CCK package and must therefore be downloaded separately—unlike the Windows installation files, which are included with CCK.) ++ + +Mozilla 1.4.1 Requirements +
+ + ++ +To test a Windows installer, you need a Windows system that meets these requirements: +
++ +
+- +Windows 95, 98, or 98SE, Windows ME, Windows NT 4.0, or Windows 2000 + +
+ +- +Pentium 233 MHz (or faster) processor + +
+ +- +At least 64 MB RAM + +
+ +- +At least 27 MB of free hard disk space + +
++ +To test a Linux installer, you need a Linux system that meets these requirements: +
++ +
+- +A computer running Red Hat Linux 6.0, 6.1, 1.4.1, or 7.0 with X11 R6. + +
++
+ +- +Note: Mozilla 1.4.1 is certified and fully supported on Red Hat Linux, but will run on other Linux distributions, such as Debian 2.1 (or later) or SuSE 6.2 (or later). (The libraries
glibc 2.1(or higher) andlibjpeg.so.62(or higher) are required.) +
- +Pentium 233 Mhz (or faster) processor + +
+ +- +At least 64 MB RAM + +
+ +- +At least 27 MB hard drive space + +
++ +To create and test a Macintosh installer, you need a Macintosh system that meets these requirements: +
++ +
+- +Mac OS 8.6 or later, Mac OS 9, or Mac OS X. (Note: customized builds produced according to the directions in this guide have been tested on Mac OS 9 and Mac OS X only.) + +
+ +- +PowerPC 604e 266 MHz or faster processor, or G3/G4 + +
+ +- +At least 64 MB RAM + +
+ +- +At least 36 MB of free hard disk space + +
++ +Important: The CCK tool works for only one version of Mozilla. For example, in order to customize Mozilla 1.4, you must use CCK 1.4, CCK 1.5 allows you to customize Mozilla 1.5 only, and CCK 1.4.1 customizes only Mozilla 1.4.1 software. The CCK download package includes the appropriate version of the Mozilla software for Windows. If you wish to create Macintosh and/or Linux installers, you need to download the standard Mozilla 1.4.1 installation files for those platforms separately. +
+
+ + ++ +The CCK tool can produce installers that run on Windows, Linux, or Macintosh: +
++ +
+- +If you set up your CCK configuration for Windows, the resulting installer will run on these platforms: + +
++ +
+ +- +Windows NT + +
+- +Windows 95 + +
+- +Windows 98 + +
+- +Windows 2000 + +
+- +Windows ME + +
+- +Windows XP
+ +- +If you set up your CCK configuration for Linux, the resulting tar file can be unpacked and installed on Red Hat Linux 6.0, 6.1, 1.4.1, or 7.0 with X11 R6. + +
+ +- +If you set up your CCK configuration for Windows, you can use the resulting files as described in Chapter 13 "Preparing Macintosh Installers and Program Files" to create a customized Mac OS 9 installer or a customized version of Mac OS X. + +
++ + +Installing the Client Customization Kit Tool +
+ + ++ +Before you install CCK, be sure to read the current Release Notes, which describe known problems and workarounds: +
+ ++ +To install the Client Customization Kit after you've downloaded the setup file: +
++ +
+- +Double-click the file
n6ccksetup.exe. + +
+ +- +Follow the instructions provided by the installer program to install CCK. + +
+ +- +When the installation program prompts you to enter the installation path for CCK, do not type any extra spaces. + +
++ + +What Customizations Can I Make? +
+ + ++ +The CCK tool allows you to make any or all of the customizations listed in the following sections. +
++ + +Mozilla Navigator Customizations +
+ + ++ +The Mozilla Navigator browser is generally the first screen users see when they start Mozilla. Customizing the browser allows you to +
++ +
+- +Bring users back to your web site (home page) every time they start Mozilla or open a browser window. + +
+ +- +Create brand awareness and promote customer loyalty. + +
+ +- +Guide users to the web pages you want them to see. + +
++ +Using the CCK tool, you can make these browser customizations: +
++ +
+- +Insert your company's logo to replace the animated Mozilla logo in Navigator's toolbar. When users click the logo, they'll go to your home page:
+ +
+ +- +Customize the bookmarks file and personal toolbar buttons.
+ +
+ +
+ +- +Add your company name to the browser window title bar and change Navigator's default home page to your company's home page.
+ +
+ +
+ +- +Add an item to the Help menu that takes users to your online technical support page.
+ +
+ +
+ +- +Include your own customized read-me file and add your company name to the program folder name in the Windows Start menu.
+ +
+ +- +Add your own sidebar to those that are visible when the browser opens a new profile for the first time.
+ +
+ +- +Set default proxy preferences + +
++ + +Mail and News Customizations +
+ + ++ +You can specify Mail and Newsgroup server settings to simplify account set up for your customers. For example, you can customize the options available on the New Account Setup wizard:
++ +
++ +You can also specify domain names, servers, ports, and other details of the default settings the user will encounter while setting up mail and news accounts. +
++ + +CD Autorun Screen Customizations +
+ + ++ +The CD autorun screen automatically appears when a user inserts a Mozilla CD into a CD-ROM drive. Using the CCK tool, you can make these customizations to the standard CD autorun screen: +
++ +
+- +customize the CD autorun screen's background bitmap image + +
+ +- +provide your own title bar text and include a line of text below the title bar + +
+ +- +customize the contents of the installation guide text file + +
++ +This illustration shows some of the elements you can customize in the standard CD autorun screen:
+
++ + +Installer Customizations +
+ + ++ +CCK creates a Mozilla installer that is both CD- and network-ready. Navigator is part of every installer. You can select which of the following components you want your installer to include: +
++ +
+- +Sun Java 2 + +
+ +- +Mail + +
+ +- +Instant Messenger + +
+ +- +Quality Feedback Agent + +
+ +- +Spell Checker + +
+ +- +AOL ART Extensions + +
+ +- +Net2Phone + +
+ +- +Macromedia Flash Player + +
+ +- +RealPlayer 8 + +
+ +- +Winamp + +
+ +- +HP Printer Identifier Plug-in + +
+ +- +Classic Skin + +
++ +Some components are not available on all platforms. See Table 9-1 for details. +
++ + +Customization Services Options +
+ + ++ +If you don't want to make the customizations yourself, Mozilla To Go makes it easy, efficient, and economical for you to distribute customized versions of Mozilla by providing these services: +
++ +
+- +Build a custom version of Mozilla 1.4.1 to your specifications. + +
+ +- +Create custom-branded disc art and packaging using your company logo. + +
+ +- +Duplicate unlimited custom or standard CDs based on your requirements. + +
++ +For more information and convenient online ordering, go to +
+ ++ + +Which Customizations Can I Make Quickly? +
+ + ++ +Some customizations don't require you to create a customized file before you start using the CCK tool. If you just want to make some quick customizations, such as changing Navigator's default home page or including your company name in the CD autorun screen, you simply enter this information directly into the CCK tool. +
++ +Table 1-1 summarizes the quick customizations you can make.
++ + +Table 1-1 Quick Customizations Checklist + +
+ +
+
+ + ++ +To run the CCK tool, open the Start menu and choose Programs, then Mozilla 1.4.1 Client Customization Kit, CCKTool. +
++ +The CCK Tool uses a standard Wizard interface to guide you through the process of customizing Mozilla 1.4.1. When you finish entering the information for a given screen, you click Next to proceed to the next screen. +
++ +For a quick hands-on tour of the simplest customizations, see Chapter 2 "Customizing Mozilla in Ten Minutes." +
++ + +Working with CCK Configurations +
+ + ++ +The first screen of the CCK tool includes a drop-down list that shows what configurations are available. You can work with configurations in the following ways: +
++ +
+- +Choose an existing configuration from the drop-down list, and run the CCK Tool using that configuration. + +
+ + +- +Choose an existing configuration from the drop-down list, click Create a Copy, and run the CCK Tool using the copy. + +
++
+ +- +This option lets you create a new customized installer that's based on an existing configuration, without overwriting the existing configuration (similar to a Save As operation). +
- +Click New Configuration to create a new configuration, and run the CCK Tool using the new configuration. + +
++ +For more information about CCK configurations, see Chapter 3 "Using the Configuration Workspace for Customized Files." +
+ + + ++ +Each time you click Next in a CCK screen, the information you entered or changed on that screen is automatically saved with your configuration. +
++ +You can exist the tool at any time and continue working with your configuration later. +
++ +To exit the CCK tool, click the Exit button on any screen. When you click Exit, the information you entered in previous screens (but not in the screen where you clicked Exit) is saved with your configuration. +
++ +You relaunch the tool at any time to continue entering information for that configuration. +
++ + +Reviewing and Verifying Your Customizations +
+ + ++ +To review all the customizations you entered in the CCK tool before building your installer, click the Show Config Info button on the final Create the Installer screen. You can also go back to any screen and make additional changes before building your installer. +
++ +Your custom installer is created in +
++
+ +installation_directory\CCKTool\Configs\my_config\Output + +++ +where installation_directory is the directory where you installed the CCK tool and my_config is the name of the configuration you are customizing. +
++ +Run your custom installer and verify that all your customizations have taken effect correctly. If you find any errors, fix the customized files involved (if necessary) and run the CCK tool again to regenerate the installer before proceeding with any manual customizations. +
++ +For more information about verifying the customizations you make with the CCK tool, see Chapter 10 "Verifying Your CCK Tool Customizations." +
+ + + + + + + +
++ + + + + diff --git a/mozilla/cck/CCKDocs/guide.html b/mozilla/cck/CCKDocs/guide.html new file mode 100644 index 00000000000..a473765a2a0 --- /dev/null +++ b/mozilla/cck/CCKDocs/guide.html @@ -0,0 +1,1123 @@ + + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + |
+
++ + + + +
++ + +Preface + + +
+ +Who Should Read This Guide + + +
+ +If You've Used a Previous Version of CCK + + +
+ +Using Existing Customized Files + +
+ +How to Use This Guide + + +
+ +Where to Go for Related Information + + +
+ +Chapter 1 + +Getting Started + + +
+ +Why Customize and Distribute Netscape? + + +
+ +Why Do Users Prefer Netscape 6.2? + +
+ +Overview of the Customization and Distribution Process + + +
+ +Netscape 6.2 Requirements + +
+ +Platform Support + + +
+ +Installing the Client Customization Kit Tool + + +
+ +What Customizations Can I Make? + + +
+ +Netscape Navigator Customizations + +
+ +Mail and News Customizations + +
+ +CD Autorun Screen Customizations + +
+ +Installer Customizations + +
+ +Customization Services Options + +
+ +Which Customizations Can I Make Quickly? + + +
+ +Working with CCK Configurations + +
+ +Reviewing and Verifying Your Customizations + +
+ +Chapter 2 + +Customizing Netscape in Ten Minutes + + +
+ +What You'll Customize + + +
+ +Quick Customization Instructions + + +
+ +Verifying Your Customizations + + +
+ +Chapter 3 + +Using the Configuration Workspace for Customized Files + + +
+ +Creating a New Installer Configuration + + +
+ +The Configuration Directory + + +
+ +Customized Files Checklist + + +
+ +Platform and Configuration Information + + +
+ +Chapter 4 + +Preparing Platform and Installer Information + + +
+ +Specifying a Platform + + +
+ +Windows + +
+ +Linux + +
+ +Deciding What Kinds of Installers to Create + + +
+ +Providing a CD-Based Installer + +
+ +User Experience of CD-Based Installation + + +
+ +Providing a Network-Downloadable Installer + +
+ +User Experience of Network-Downloadable Installer (Windows) + + +
+ +User Experience of Network Downloadable Installer (Linux) + + +
+ +User Experience of Network Downloadable Installer (Macintosh) + + +
+ +Choosing a Company Identifier + + +
+ +Checklist for Platform and Installer Screens + + +
+ +Chapter 5 + +Preparing to Customize the Netscape Browser + + +
+ +Creating a Custom Animated Logo + + +
+ +Step 1: Create the Animation Frames + +
+ +Step 2: Assemble Your Frames Using a GIF Animation Program + +
+ +Determining a Help URL and Menu Item + + +
+ +Determining the Name of the Program Folder in the Windows Start Menu + + +
+ +Preparing a Customized Read-me File + + +
+ +Creating Your Own Sidebar Tab + + +
+ +Rearranging My Sidebar Tabs + +
+ +Specifying the Default Home Page + + +
+ +Preparing Your Customized Bookmarks and Personal Toolbar + + +
+ +Creating a New User Profile + +
+ +Creating Custom Bookmarks and Personal Toolbar Buttons + +
+ +Determining Text for the Browser Window's Title Bar + + +
+ +Checklists for Customizing the Browser + + +
+ +Customize the Browser - Part One + +
+ +Customize the Browser - Part Two + +
+ +Customize the Browser - Part Three + +
+ +Chapter 6 + +Preparing to Customize Netscape Mail and News + + +
+ +Specifying Mail Domain and Server Settings + + +
+ +Incoming Server Settings + +
+ +Outgoing Server Setting + +
+ +Specifying News Domain and Server Settings + + +
+ +Domain + +
+ +Netscape Activation Considerations for Mail and News + + +
+ +Checklists for Customizing Mail and News + + +
+ +Customize Netscape Mail + +
+ +Customize Netscape News + +
+ +Chapter 7 + +Preparing to Customize Proxy Configurations + + +
+ +About Proxy Configurations + + +
+ +Default Network Proxy Configurations + + +
+ +Chapter 8 + +Preparing to Customize the CD Autorun Screen + + +
+ +What Is the CD Autorun Screen? + + +
+ +About the Default CD Autorun Screen + +
+ +Customizing the Standard CD Autorun Screen + +
+ +Customizing the CD Autorun Screen's Background Image + + +
+ +Editing the Standard Background Image + +
+ +Creating Your Own Custom Background Image + +
+ +Customizing Text for the CD Autorun Screen + + +
+ +Customizing the Installation Document + + +
+ +Checklist for Customize the CD Autorun Screen + + +
+ +Chapter 9 + +Preparing to Create the Installer + + +
+ +Selecting Netscape Components + + +
+ +Providing Additional Installers + + +
+ +Chapter 10 + +Verifying Your CCK Tool Customizations + + +
+ +Installing Your Customized Build + + +
+ +Verifying Your Browser Customizations + + +
+ +Verifying Your Mail and News Customizations + + +
+ +Verifying Your Installer Customizations + + +
+ +Chapter 11 + +Manually Customizing the CD Autorun Screen + + +
+ +Why Manually Customize the Standard CD Autorun Screen? + + +
+ +Run The CCK Tool First + + +
+ +About the CD Autorun Files + + +
+ +Tools for Customizing the Standard Autorun Screen + + +
+ +Creating a CD Staging Area on Your Hard Disk + + +
+ +Understanding the rshell.ini File + + +
+ +General Settings in the rshell.ini File + +
+ +Text for Browse, Back, and Exit Buttons + + +
+ +Positions of Browse, Back, and Exit Buttons + + +
+ +Bitmaps for the Browse, Back, and Exit Buttons + + +
+ +Caption Text + + +
+ +Dialog Position + + +
+ +Button Gap + + +
+ +Dialog Title Position + + +
+ +Dialog Title Text Color + + +
+ +Dialog Title Text Font + + +
+ +Dialog Title Text Style + + +
+ +Global Button Text Settings + +
+ +Text Colors + + +
+ +Button Title and Body Text + + +
+ +Button Body Text Style + + +
+ +Column Settings Within a Dialog + +
+ +Position of First Button in Column One + + +
+ +Position of a Button's Descriptive Text + + +
+ +Button Settings Within a Dialog + +
+ +Button Bitmaps + + +
+ +Button Offset + + +
+ +Editing the rshell.ini File + + +
+ +Adding A Background Image to a Dialog Screen + +
+ +Customizing a Screen's Title Bar Text + +
+ +Adding a New Button to a Screen + +
+ +Verifying Your CD Autorun Screen Manual Customizations + + +
+ +Chapter 12 + +Advanced Netscape Customizations + + +
+ +Understanding How Manual Customization Works + + +
+ +Understanding the Preferences Architecture + + +
+ +Important Legal Restrictions + +
+ +Before You Start + + +
+ +Editing a Configuration File with a Text Editor + + +
+ +Instructions for Common Manual Customizations + + +
+ ++ +Customizing the Welcome Page + +
+ +Chapter 13 + +Preparing Macintosh Installers and Program Files + + +
+ +Tools Required + + +
+ +Creating a Customized Macintosh Installer + + +
+ +Create a Customized Mac OS 9 Installer + +
+ +Creating a Mac OS X Installer + +
+ +Chapter 14 + +Distributing Your Installers + + +
+ +Distributing a CD-Based Installer + + +
+ +Verifying Your CD Layout (No Autorun Screen) + +
+ +Linux CD Layout + + +
+ +Assembling Your CD Layout (Autorun Screen) + +
+ +Preparing Your CD-Ready Files for CD Distribution + +
+ +Distributing Network-Downloadable Installers or Binaries + + +
+ +End-User Instructions for Windows + +
+ +End-User Instructions for Macintosh + +
+ +End-User Instructions for Linux + +
+ +Appendix A + +Resources for ISPs + + +
+ +Setting Up Your Servers and Internet Feed + + +
+ +Preparing Your Account Setup Solution + + +
+ +Troubleshooting and Customer Support + + +
+ +Appendix B + +Manual Account Setup + + +
+ +Preliminaries + + +
+ +Create a Modem Location + + +
+ +Set Up TCP/IP + + +
+ +Log On and Start Mozilla + + +
+ +Appendix C + +Mozilla Profile Locations by Platform + + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/info_cck.htm b/mozilla/cck/CCKDocs/info_cck.htm new file mode 100644 index 00000000000..4052cb24e2d --- /dev/null +++ b/mozilla/cck/CCKDocs/info_cck.htm @@ -0,0 +1,843 @@ + + + + + + + + +
+
+ + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 4 + + + + + +Preparing Platform and Installer Information +
+ +The second and third screens presented by the CCK tool allow you to choose a platform and specify other basic information about your installer. +
++ +This chapter describes the information you need to prepare for these initial screens. It contains these sections: +
++ +Deciding What Kinds of Installers to Create
+
Choosing a Company Identifier
Checklist for Platform and Installer Screens +
+ + ++ +The CCK tool can generate an installer for use on Windows or Linux. It's also possible to create a Macintosh installer by replacing some of the standard Macintosh installation files with the equivalent installation files produced for a Windows installer. +
+ + + ++ +No special preparation is required to create a Windows installer. You simply select Windows from the drop-down list on the second screen of the CCK tool, called Specify Platform Information, and proceed through the other screens. +
++ +The Windows installation files produced by the CCK tool will run on the following Windows platforms: +
++ +
+ + + +- +Windows NT + +
+ +- +Windows 95 + +
+ +- +Windows 98 + +
+ +- +Windows 2000 + +
+ +- +Windows ME + +
+ +- +Windows XP + +
++ +To prepare a Linux installer, you should first download a Mozilla 1.4.1 Linux tar file to some convenient location. The tar file you should download is named
+mozilla-i686-pc-linux-gnu-sea.tar.gz. ++ +After you choose Linux as the platform for the current configuration on the second screen of the CCK tool, called Specify Platform Information, you can specify that location in the field provided. +
++ +You need to specify the location of the Linux tar file only once. After you do so, the CCK tool creates a directory
+CCKTool\nscpxpiLinux\and stores the decompressed standard Linux installation files there. ++ +If you decide later that you want the CCK tool to start fresh with a Linux tar file, you must delete the directory
+CCKTool\nscpxpiLinux\and its contents. The next time you run the CCK tool, you will again be able to specify the location of the Linux tar file. ++ +In addition to downloading a Mozilla 1.4.1 Linux tar file, you must have GNU Tools for Microsoft Windows (the Cygnus toolkit) installed on the system before running the CCK tool. You can obtain the Cygnus toolkit from
+http://www.cygwin.com/. You must also make sure that the path to the binaries for the Cygwin Unix programs is included in the Windows environment variable called PATH. To check the PATH variable, open the System control panel and click the Environment tab. ++ +After you click the Build Installer button on the last screen of the CCK tool, the tool provides the customized Linux build as a tar file in +
++ +You can then transfer this tar file to a Linux system and then extract the contents for testing. +
++ +After you extract the contents of the tar file, you must also change the permission of the file
+ + + +mozilla-installer-binto include executable permission. You can then run the install script by typing./mozilla-installer. ++ +To prepare Macintosh installers, you first use the CCK tool to create a Windows installer, then follow the instructions in Chapter 13 "Preparing Macintosh Installers and Program Files." +
++ + +Deciding What Kinds of Installers to Create +
+ + ++ +The CCK tool lets you create two types of installers: +
++ +
+- +CD-based installers, for distributing Mozilla to your users on a CD + +
+ +- +Network-downloadable installers that users can download from your network, and then install Mozilla on their hard disks. + +
++ +The advantages and disadvantages of each type of installer are described in the sections that follow. +
++ + +Providing a CD-Based Installer +
+ + ++ +Distributing your Mozilla installer on a CD has these advantages: +
++ +
+- +It's the best way to distribute Mozilla to users who don't have Internet access or who are new to the web. + +
+ +- +It's convenient; all the software users need to get started is included on the CD. + +
+ +- +When a user inserts the CD in a CD-ROM drive, the CD autorun screen automatically appears, simplifying installation. + +
+ +- +You can customize the CD autorun screen to make it easy for users to install any other software you want to include on the CD along with Mozilla. + +
+ +- +You can customize the CD autorun screen to promote your company's products, services, and brand identity. + +
++ +The main disadvantage of distributing Mozilla on a CD is you may need to update and re-distribute the CD as newer versions become available. +
++ + +User Experience of CD-Based Installation +
++ +If you've chosen to include the CD autorun screen with your CD-ready installer, it automatically launches when the user inserts the CD. The user can then follow the instructions on the CD autorun screen to install your customized version of Mozilla. +
++ +If you've customized the CD autorun screen, either by using the CCK tool or by making manual customizations (as described in Manually Customizing the CD Autorun Screen), users will see your customized CD autorun screen instead of the standard one. +
++ +If for some reason the CD autorun screen is included with the installer but doesn't automatically appear when the user inserts the CD, the user must double-click the
+setup.exe file(Windows) or Mozilla Installer file (Macintosh) located at the CD root to launch the CD autorun screen. ++ +If you've chosen not to include the CD autorun screen, the user must double-click the
+setup.exefile (Windows) or the Mozilla Installer file (Mac OS 9) located at the CD root to launch the Mozilla installer. ++ +For Mac OS X, the customized files do not require installation: the user simply copies them to a convenient location and double-clicks the Mozilla application icon to launch Mozilla. +
++ +To run the Linux installer, the user must run the install script by typing the command
+./mozilla-installer. ++ + +Providing a Network-Downloadable Installer +
+ + ++ +If you distribute your Mozilla installer over a network, you don't have to pay for postage, packaging, and CD duplication. Also, as new versions of Mozilla become available, you can readily provide them on your web site. +
++ +Since users must already have Internet access, distributing Mozilla over a network is primarily useful for upgraders or users who want to switch to Mozilla from another web browser. Also, users must have a modem capable of transferring data at a rate of 56 Kbps or faster to keep the download time within acceptable limits. +
++ +Table 4-1 lists approximate download times for an installation that includes Navigator and Mail only (approximately 11 MB). Actual download times may vary.
+ +
+
++
+ + + ++ ++ + ++ + ++ + + ++ ++ ++ ++ + ++ ++ ++ ++ + ++ ++ ++ ++ + ++ ++ ++ ++ + ++ ++ ++ ++ + ++ + ++ ++ ++ + ++ +To distribute a network-downloadable installer, you'll need to set up an FTP (File Transfer Protocol) site so users can download the Mozilla installer from your site. You'll also need to tell users where to find the installer and provide them with instructions for downloading it. +
++ + +User Experience of Network-Downloadable Installer (Windows) +
++ +To install Mozilla on Windows, a user +
++ +
+- +Launches another browser or FTP program and downloads a small (300 Kbytes) installer program (
Setup.exe) from your FTP site to the user's hard disk. + +
+ +- +Double-clicks the
Setup.exeprogram to begin the installation process. TheSetup.exeprogram displays a series of screens that guide the user through the entire installation process. + +
+ +- +During the installation process, the installer downloads the necessary Mozilla component files from your FTP site and installs them on the user's machine. While downloading is in progress, the user can pause the download process and resume the download later. + +
+ +- +When the installation is complete, Mozilla launches. + +
++ + +User Experience of Network Downloadable Installer (Linux) +
++ +To install Mozilla on Linux, a user +
++ +
+- +Launches another browser or FTP program and downloads a small (300 Kbytes) installer program (
mozilla-installer-bin) from your FTP site to the user's hard disk. + +
+ +- +Runs the install script by typing the command
./mozilla-installer. + +
+ +- +During the installation process, the installer downloads the necessary Mozilla component files from your FTP site and installs them on the user's machine. While downloading is in progress, the user can pause the download process and resume the download later. + +
+ +- +When the installation is complete, Mozilla launches. + +
++ + +User Experience of Network Downloadable Installer (Macintosh) +
++ +To install Mozilla on Mac OS, a user +
++ +
+- +Launches another browser or FTP program and downloads a single self-extracting archive that contains all the installation files. + +
+ +- +Double-clicks the downloaded file called Mozilla 1.4.1 Installer to begin the installation process. The installer program displays a series of screens that guides the user through the entire installation process. + +
+ +- +When installation is complete, users must double-click the Mozilla application icon (or its alias) to launch Mozilla. + +
++ + +Choosing a Company Identifier +
+ + ++ +The only required item on the Gathering Information screen is your company identifier for the user agent string. The user agent string helps identify the browser type whenever the browser accesses your web site or any other web site. Your identifier in the user agent string allows your company (or others) to track the number of times Internet web sites are accessed by web browsers that you've customized. +
++ +The identifier you supply can be up to 10 characters in length. +
++ +For example, if you enter
+MyISPin the Company Identifier field, the resulting user agent string would look like this: ++ +If you are preparing several different customized versions of Mozilla, you may want to supply a different user agent string for each one. +
++ + +Checklist for Platform and Installer Screens +
+ + ++ +The Specify Platform Information Screen specifies: +
++ +
+- +Whether you want the CCK tool to generate a Windows or a Linux installer. + +
+ +- +The location of the standard Linux tar file for Mozilla 1.4.1 (if you select Linux as the platform). + +
++ +The Gathering Information screen specifies: +
++ +
+- +Whether you want a CD autorun screen. + +
+ +- +The FTP URL for an network-ready installer (if any). + +
+ +- +The company identifier to be included in the user agent string for your customized Mozilla (recommended). + +
++ +Make sure you have this information available when you run the CCK tool. +
+ +
++ + + + + diff --git a/mozilla/cck/CCKDocs/installer_cck.htm b/mozilla/cck/CCKDocs/installer_cck.htm new file mode 100644 index 00000000000..c0694c71063 --- /dev/null +++ b/mozilla/cck/CCKDocs/installer_cck.htm @@ -0,0 +1,687 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 9 + + + + + +Preparing to Create the Installer +
+ +The final screen presented by the CCK tool, called Create the Installer, allows you to specify which Mozilla components you want your installer to install. You can also use this screen to specify up to two additional installers to include with your customized Mozilla installation package. +
++ +This chapter describes the Mozilla components you can choose from and the requirements for additional installers you may wish to create. +
++ +This chapter contains these sections: +
++ +Selecting Mozilla Components
+
Providing Additional Installers ++ + +Selecting Mozilla Components +
+ + ++ +Table 9-1 lists the optional components that you can include (or exclude) for your customized Mozilla installer. +
++ +Note that Mozilla browser is always installed. If you choose not to include any additional components, your Mozilla installer will install Mozilla browser only.
++ + +Table 9-1 Optional components you can include in your Mozilla installer + +
+ +
++
+ + + ++ ++ + ++ + ++ + ++ + ++ + + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ ++ ++ ++ ++ ++ + ++ + ++ ++ ++ ++ ++ + ++ + +Providing Additional Installers +
+ + ++ +You can include installers for up to two additional products in your Mozilla installer. When the user installs the recommended Mozilla configuration, the additional installers are automatically installed after the main Mozilla installation completes. However, if the user chooses the Custom path when installing Mozilla, the user can choose not to install the additional components. +
++ +Each installer must consist of a single, self-extracting executable (
+.exe) file, such as those created by installation creation programs such as InstallShield from InstallShield Software Corporation. Before you run the CCK tool, place your installers here for convenience: ++
+ +installation_directory\CCKTool\Configs\my_config\Workspace\CustInst\ + +++ +You specify a path to the additional installers in the last screen presented by the CCK tool: "Create the Installer." +
++ +Important: When you specify the size in kilobytes of each installer, Mozilla recommends that you enter a number approximately three times the size of the actual installer
+ + +.exefile, to ensure that the installer has enough room to expand and install the program on the user's hard disk. +
++ + + + + diff --git a/mozilla/cck/CCKDocs/isp_appx_cck.htm b/mozilla/cck/CCKDocs/isp_appx_cck.htm new file mode 100644 index 00000000000..18421cb1c53 --- /dev/null +++ b/mozilla/cck/CCKDocs/isp_appx_cck.htm @@ -0,0 +1,447 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2003
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Appendix A + + + + + + + +Resources for ISPs +
++ +Setting up an ISP involves a range of business, financial, and technical issues. This appendix provides links to online sources for more detailed information. +
++ +This appendix contains these sections: +
++ +Business Planning
+
Setting Up Your Servers and Internet Feed
Preparing Your Account Setup Solution
Troubleshooting and Customer Support +
+ + ++ +Before you begin planning the technical details of your ISP, you need to address a range of basic business issues, including market research, financing, and setting up your basic business infrastructure. At a minimum, this includes obtaining necessary state and local licenses, setting up office services such as phone systems and accounting software, domain registration, and so on. +
++ +You should also have identified your potential customers, created a viable marketing and business plan, worked out a detailed budget, identified sources of technical assistance (your own employees or external services), and performed all the other tasks required to set up a successful business. The ISP industry is mature and highly competitive; you will not succeed unless you do your homework. +
++ +For background information on planning and setting up an ISP business, see the following: +
++ +
+- +
http://www.isp-planet.com/+ +
+ +- +Can I start an ISP with $15000?
http://www.isp-planet.com/business/2001/15k_bol.html+ +
+ +- +Newbie's Guide to Starting an ISP
http://www.isp-planet.com/business/start_an_isp-a.html+ +
+ +- +ISPPlanet Guide to Building an ISP
http://www.isp-planet.com/resources/isp_guide/index.html+ +
+ +- +How We Started Our Own ISP
http://www.techtv.com/screensavers/showtell/story/0,23008,2196566,00.html+ +
++ + +Setting Up Your Servers and Internet Feed +
+ + ++ +To provide Internet access, an ISP needs to sign up with a regional or national backbone provider and set up a local loop—that is, a physical connection between your location and the provider. In general, it's preferable to set up a 24 channel T1 or equivalent circuit for your first access switch. +
++ +An ISP also needs servers to handle its primary functions, including DNS, mail, Web servers (both HTTP and HTTPS), authentication, and news. Theoretically, you can do all this on just one machine, but at least four separate dedicated PCs is usually considered the minimum requirement. +
++ +One of the most basic decisions you must make is whether to own your own server facilities, rent them, or use a hybrid solution that permits users to connect to your service through other service providers as well as your own. +
++ +For more information on these decisions and other aspects of setting up your servers and Internet feed, see the following: +
++ +
+- +Make Your ISP Facilities-Based or Non? (
http://www.isp-planet.com/business/052099facilities-pt1.html) in ISPPlanet Guide to Building an ISP. + +
+ +- +Newbie's Guide to Starting an ISP
http://www.isp-planet.com/business/start_an_isp-a.html+ +
+ +- +What Do I Need for My WebSite?
http://www.cultureandrecreation.gov.au/resources/guides/g8/s1.htm+ +
++ + +Preparing Your Account Setup Solution +
+ + ++ +When a customer signs up with your ISP service, you need to provide an Account Setup solution as well as a customized version of Mozilla 1.4.1. An Account Setup solution helps users create ISP accounts and configures both system software and Mozilla 1.4.1 to enable Internet access. Configuration includes: +
++ +
+- +System software (such as modem drivers, dialers, network protocol stack) + +
+ +- +Internet access information (such as dialup access numbers, network settings, server settings) + +
+ +- +End-user-specific settings (such as ISP account name, user email address) for Mozilla + +
++ +An Account Setup solution can take one of two forms: +
++ +
+- +Online Account Setup prompts for customer information to create an ISP account (for example, contact information, preferred email account name, and payment plan). Account Setup then connects to an ISP account setup server and uploads the new account request. After processing the request, the server downloads the corresponding configuration to Account Setup, which uses it to automatically configure Internet access and other settings for the end user. + +
+ +- +Manual Account Setup requires the end user to enter the appropriate configuration information manually and initiate the connection process. Therefore, you need to provide step-by-step instructions for each platform that you support. For example, see the instructions outlined in Appendix B "Manual Account Setup." + +
++ + +Troubleshooting and Customer Support +
+ + + +
++ + + + + diff --git a/mozilla/cck/CCKDocs/mac_linux_cck.htm b/mozilla/cck/CCKDocs/mac_linux_cck.htm new file mode 100644 index 00000000000..f9fae4c9bba --- /dev/null +++ b/mozilla/cck/CCKDocs/mac_linux_cck.htm @@ -0,0 +1,583 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2001 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 13 + + + + + +Preparing Macintosh Installers and Program Files +
+ +To create a customized Macintosh installer, you first create a customized Windows installer, then transfer the customized Windows files to a standard Macintosh installation package (for Mac OS 9) or an installed version of Mozilla 1.4.1 (for Mac OS X). This chapter provides detailed instructions for this procedure. +
++ +Note: If you are preparing a Linux installer, you simply transfer the tar file generated by the CCK tool file to a Linux system for testing and distribution. For details, see Chapter 4 "Preparing Platform and Installer Information." +
++ +This chapter contains these sections: +
++ +Tools Required
+
Creating a Customized Macintosh Installer +
+ + ++ +To create a customized Mozilla browser installer for Macintosh systems, you need these Macintosh tools: +
++ +
+- +Stuffit Deluxe 5.5 or higher, which is available from your local computer store or through
http://www.aladdinsys.com/store/+ +
+ +- +ZipIt 1.3.8 or higher, shareware available through
http://www.zdnet.com/downloads/+ +
++ + +Creating a Customized Macintosh Installer +
+ + ++ +The first five steps involved in creating a customized Macintosh installer are common to both Mac OS 9 and Mac OS X: +
++ +
+- +Use the CCK tool to create a customized Mozilla 1.4.1 installer for Windows as described in previous chapters. + +
+ +- +Locate the Output directory: + +
+ +- +Use WinZip or a similar utility to extract these jar files: + +
++ +
+ +- +From
+browser.xpi:modern.jar, comm.jar+ +- +From
+langenus.xpi:en-US.jar+ +- +From
+skinclas.xpi:classic.jar+ +- +From
regus.xpi:US.jar+ +- +Use Winzip or a similar utility to extract these additional files: + +
++ +
+ +- +From
+browser.xpi:all-ns.js,comm.jar/communicator:communicatorOverlay.xul+ +- +From
+deflenus.xpiorregus.xpi:panels.rdf+ +- +From
+deflenus.xpi orregus.xpi:bookmarks.html+ +- +From
+deflenus.xpiorregus.xpi:mailaccount.rdf(this file will not be present unless you customized the Mail settings) + +- +From
deflenus.xpiorregus.xpi:newsaccount.rdf(this file will not be present unless you customized the News settings)
+ +- +Transfer all of the files listed in the preceding steps to a Macintosh running Mac OS 9 or Mac OS X. + +
++ +At this point, the instructions differ depending which operating system you are running: +
++ +Create a Customized Mac OS 9 Installer
+
Creating a Mac OS X Installer ++ + +Create a Customized Mac OS 9 Installer +
+ + ++ +After you complete steps 1 through 5 above under"Creating a Customized Macintosh Installer," follow these steps to create a Mac OS 9 installer: +
++ +
+- +Go to
http://www.mozilla.organd download the Full Installer for the Mac OS 9 version of Mozilla 1.4.1. + +
+ +- +Locate the Installer Modules folder inside the Mozilla Full Installer (auto-expanded) folder. + +
+ +- +Select
browser.xpi,langenus.xpi, andregus.xpiand extract the complete contents of these files. + +
++
+ +- +If you are using the ZipIt utility, first set the preferences as shown here:
+ +
+
- +
+ +
+
- +Within the ZipIt window, open
viewer/chrometo locate the jar files (forall-ns.js, openviewer/defaults/pref). +
- +Replace the extracted files specified below with those that you transferred from Windows, then zip up the
.xpifiles again and replace the original.xpifiles in the original locations: + +
++ +
+ +- +Replace the file
+comm.jar/communicator/communicatorOverlay.xulwith Windows equivalent frombrowser.xpi. + +- +Replace the jar files from Macintosh
+browser.xpiwith the Windows equivalents frombrowser.xpiandskinclas.xpi. + +- +Replace
+en-US.jarfromlangenus.xpiandUS.jarfile fromregus.xpiwith the Windows equivalents. + +- +Replace
+all-ns.jsfrombrowser.xpiwith the equivalent Windows file. + +- +Replace
+panels.rdf,bookmarks.html, fromdeflenus.xpi(viewer/defaults/isp) andregus.xpi(viewer/defaults/isp/us) with the Windows equivalents. + +- +Add
mailaccount.rdfandnewsaccount.rdffrom the customized Windows installation to thedeflenus.xpi(viewer/defaults/isp) andregus.xpi(viewer/defaults/isp/us) directories. (Unlike the other files,mailaccount.rdfandnewsaccount.rdfare not part of the standard Macintosh installer.)
+ +- +To customize the Welcome Dialog or to add or subtract components, use a text editor to modify the file
Config.ini. + +
+ +- +Use the Stuffit utility to create a self-extracting archive from the Mozilla Full Installer folder. + +
+ +- +Verify the customization by expanding the executable, then install the build and check for the appropriate customizations, as with Windows builds. + +
++ +If you are creating a network installer, use the self-extracting archive. Users will download this file, extract its contents, and run the Mozilla Installer file to install Mozilla. +
++ +If you are creating a CD, use the Mozilla Full Installer directory for the contents of the Macintosh partition, not the self-extracting archive. +
++ + +Creating a Mac OS X Installer +
+ + ++ +After you complete steps 1 through 5 above under "Creating a Customized Macintosh Installer," follow the steps in this section to create a Mac OS X installer. +
++ +Note: You can perform steps 1 through 7 on either Mac OS 9 or Mac OS X. +
++ +
+ + +- +Go to
http://www.mozilla.organd download the binary file for the Mac OS X version of Mozilla 1.4.1. + +
+ +- +Unpack the binary with ZipIt or StuffIt. + +
+ +- +Replace the Mac OS X jar files (
modern.jar,en-US.jar,classic.jar, andUS.jar) in/chromewith the corresponding files from the Windows installer. + +
+ +- +Replace the Mac OS X file
all-ns.jsin/Defaults/Prefwith the corresponding file from the Windows installer. + +
+ +- +Replace the Mac OS X files
mailaccount.rdfandnewsaccount.rdfin/Defaults/ispand/Defaults/isp/USwith the corresponding files from the Windows installer. + +
+ +- +Replace the Mac OS X files
panels.rdfandbookmarks.htmlin/Defaults/Profileand/Defaults/Profile/USwith the corresponding files from the Windows installer. + +
+ +- +Replace the Mac OS X file
communicatorOverlay.xulin/chrome/comm.jar/communicator/communicatorOverlay.xulwith the corresponding file from the Windows installer. + +
+ +- +Verify your customization by launching Mozilla on Mac OS X and checking for the appropriate customizations, as with Windows builds. + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/mail_news_cck.htm b/mozilla/cck/CCKDocs/mail_news_cck.htm new file mode 100644 index 00000000000..e970a1a7a7b --- /dev/null +++ b/mozilla/cck/CCKDocs/mail_news_cck.htm @@ -0,0 +1,619 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 6 + + + + + +Preparing to Customize Mozilla Mail and News +
+ +The CCK tool includes two screens that specify default domain and server settings for new mail and news accounts created with your customized version of Mozilla. This chapter describes the information you need to have on hand if you want to customize these mail and news settings. +
++ +This chapter contains these sections: +
++ +Specifying Mail Domain and Server Settings
+
Specifying News Domain and Server Settings
Checklists for Customizing Mail and News ++ + +Specifying Mail Domain and Server Settings +
+ + ++ +Before specifying custom mail domain and server information, you should set up and test your mail server and confirm the settings described here. +
+ + + ++ +The CCK tool allows you to specify the following mail domain information: +
++ +
+- +Domain name. The default email domain that you want to appear in the Mozilla Mail account settings. For example, if you enter "myisp.net" in this field, Mozilla automatically appends each user's name with "@myisp.net" when your users set up their accounts. The domain name field also determines default domain values in the instructions that appear on the Identity screen of the Account Wizard, which leads users through the process of setting up their mail accounts. + +
+ +- +Display name. The mail account name that you want to appear as the Mail Folder in the left frame of the main Mozilla Mail screen. For example, "MyISP Mail". + +
+ +- +Mail provider. The mail provider name that you want to appear in the New Account Setup screen, where users are prompted to select the type of account that they would like to set up, such as a newsgroup, email, or Webmail. This screen includes a variety of options; choices include AOL and Mozilla accounts, so the more specific you make this text, the more helpful to your customer. For example, to be consistent with other choices on this account setup list, you might specify a name such as "My ISP Mail Account". + +
++ + +Incoming Server Settings +
+ + ++ +The CCK tool allows you to specify default settings for the incoming mail server. These settings appear in the Server Settings section of each new mail account listed under Mail & Newsgroups Account Settings. To view these settings in Mozilla: +
++ +
+- +In the Mozilla Mail & Newgroups window, open the Edit menu and choose Mail & Newsgroups Account Settings. + +
+ +- +Click Server Settings. + +
++ +These are the default Server Settings that you can specify with the CCK tool: +
++ +
+- +Server name. The name of the incoming server. For example:
myisp.mail.net+ +
+ +- +Port number. The port for the incoming server. The standard port number is 110. + +
+ +- +Server type. Choose POP or IMAP. If you choose POP, you can also choose to leave messages on the server even after the user deletes them in the Mozilla Mail program. + +
++ + +Outgoing Server Setting +
+ + ++ +The CCK tool allows you to specify the default outgoing mail server. This setting appears in the Outgoing Server (SMTP) section under Mail & Newsgroups Account Settings. +
++ +To view the Outgoing Server (SMTP) panel: +
++ +
+- +In the Mozilla Mail & Newgroups window, open the Edit menu and choose Mail & Newsgroups Account Settings. + +
+ +- +Click Outgoing Server (SMTP). + +
++ +You specify only the Outgoing Server name with the CCK tool: +
+ ++ + +Specifying News Domain and Server Settings +
+ + + + + ++ +The CCK tool allows you to specify the following News domain information: +
++ +
+ + + +- +Domain name. Enter the default News domain that you want to appear in the Mozilla newsgroup account settings. Note that this domain name must be different than the domain name you used for Mail. For example, if your mail domain is "myisp.net," News domain of "myisp.news.net" would work, but "myisp.net" would not. + +
++
+ +- +The domain name field also determines default domain values in the instructions that appear on the Identity screen of the Account Wizard, which leads users through the process of setting up their mail accounts. +
- +Display name. The News account name that you want to appear near the bottom of the left frame of the main Mozilla Mail screen. For example, "MyISP News". + +
+ +- +Mail provider. The News provider name that you want to appear in the New Account Setup screen, where users are prompted to select the type of account that they would like to set up, such as a newsgroup, email, or Webmail. This screen includes a variety of options, so the more specific you make this text, the more helpful to your customers. For example, to be consistent with other choices on this account setup list, you might enter a string such as "My ISP News Account". + +
++ +The CCK tool allows you to specify the following News server information: +
++ +
+- +Server name. The name of the News server. For example:
myisp.news.net+ +
+ +- +Port number. The port for the News server. The standard port number is 119. + +
++ +To set up your mail account at this point, your customer must open the Edit menu, choose Mail & Newsgroup Account Settings, click on the New Account button, and then select your customized account option. After completing the customized account setup, the customer must click Set as Default button to make the new account the default mail account. +
++ + +Checklists for Customizing Mail and News +
+ + + + + ++ +The screen called Customize Mozilla Mail specifies the following: +
++ +
+ + + + + + +- +Domain + +
+ + +- +Incoming Server + +
+ + +- +Outgoing Server (SMTP) + +
+ +
++ + + + + diff --git a/mozilla/cck/CCKDocs/pixel.gif b/mozilla/cck/CCKDocs/pixel.gif new file mode 100644 index 00000000000..3ea701d944e Binary files /dev/null and b/mozilla/cck/CCKDocs/pixel.gif differ diff --git a/mozilla/cck/CCKDocs/preface_cck.htm b/mozilla/cck/CCKDocs/preface_cck.htm new file mode 100644 index 00000000000..21437727ff5 --- /dev/null +++ b/mozilla/cck/CCKDocs/preface_cck.htm @@ -0,0 +1,860 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
+ ++ +This guide describes how to customize and distribute Mozilla 1.4.1. It includes information on how to +
++ +
+- +Find information on setting up and running an ISP. + +
+ +- +Use the Mozilla Client Customization Kit (CCK) tool to create customized Mozilla 1.4.1 installers for Windows, Linux, and Macintosh. + +
+ +- +Make additional customizations by manipulating the installation files. + +
+ +- +Prepare the final, customized installation files for delivery on CD-ROM or by network download. + +
+ +- +Provide your users with basic account setup information. + +
++ +Before using the CCK tool or this guide, be sure to check the latest Mozilla 1.4.1 Client Customization Kit Release Notesand sign up for the Browser Distribution Program. For details on where to find these and other important sources of information, see Where to Go for Related Information. +
++ +This preface contains these sections: +
++ +Who Should Read This Guide
+
About the CCK Tool
If You've Used a Previous Version of CCK
How to Use This Guide
Where to Go for Related Information ++ + +Who Should Read This Guide +
+ + ++ +This guide is intended for organizations that need a simple solution for customizing Mozilla and distributing it to their end users. If you are an ISP or distributor, for example, you can use the Client Customization Kit (CCK) to create and distribute customized versions of Mozilla 1.4.1. +
++ +This guide describes how to use the CCK tool to create a customized Mozilla 1.4.1 installer, prepare it for cross-platform distribution via CDs and/or network installers, and ensure that your customers can easily connect to their Internet accounts using a modem and phone line. +
+
+ + ++ +The CCK tool allows you to customize basic Mozilla preferences and defaults and add your own branding elements to the Navigator browser, the CD autorun screen, and the Mozilla installer. These customizations can help promote your business, simplify account set up for new users, drive traffic to your site, and reduce service and support costs by providing links to online resources. +
++ +The CCK Tool creates Mozilla installers for Windows 95/98, Windows 2000, Windows NT, and Linux operating systems. You can also produce a Macintosh version by completing additional manual steps (documented in this guide) after you produce a Windows version. +
++ +The CCK tool lets you create the simplest set of customizations in just a few minutes. These customizations, which require minimal preparation, include the following: +
++ +
+- +Display your company name in the browser window's title bar, the CD autorun screen, and the Mozilla program folder in the Windows Start menu. + +
+ +- +Set the browser's default home page to your own home page. + +
+ +- +Specify Mail and News server settings. + +
+ +- +Create a Mozilla installer that installs only the components you want your users to have. + +
++ +The CCK tool also helps you create the following customizations, which require some preparation before you run the tool: +
++ +
+- +Browser customizations: + +
++ +
+ +- +Create a custom animated logo + +
+- +Add a Help menu item and corresponding URL + +
+- +Customize the read-me file + +
+- +Rearrange the Sidebar tabs + +
+- +Customize Bookmarks and the Personal Toolbar folder
+ +- +CD autorun screen customizations: + +
++ +
+ +- +Create custom background image + +
+- +Customize on-screen text + +
+- +Customize the installation document
+ +- +Installer customizations + +
+ ++ +After you have run the tool and tested its customizations, you can perform a wide range of advanced manual customizations by modifying the installation files. Manual customizations include: +
++ +
+- +Advanced customizations for the CD autorun screen + +
+ +- +Advanced Mozilla customizations (such as presetting proxy preferences) + +
++ +After you have tested your manual customizations, you may need to manipulate the installation files further to create Macintosh installers. In addition, you'll need to prepare to distribute your installers (by means of CDs or network-downloadable installers) and plan for post-distribution support, such as account setup and troubleshooting. +
++ + +If You've Used a Previous Version of CCK +
+ + ++ + +Using Existing Customized Files +
+ + ++ +In most cases you can use your existing customized files without having to make any changes to them. Refer to Table 1 for information on using existing customized files with the CCK tool. +
++ + +Table 1 Using Existing Customized CCK 4.x Files + +
+ +
++
+ + + ++ ++ + ++ + + ++ ++ ++ + ++ +No longer supported. For information on preferences formerly included in this file, see Chapter 12 "Advanced Netscape Customizations." +
+ ++ ++ + ++ +No changes are necessary. +
+ +For information on incorporating this file into your Mozilla installer, see Chapter 11 "Manually Customizing the CD Autorun Screen." +
+ ++ ++ +Any custom files you've created for the CD autorun screens, such as custom
.bmpimages (for background images and buttons on the Autorun screens) ++ + ++ +For information on incorporating these files into your Mozilla installer, seeChapter 11 "Manually Customizing the CD Autorun Screen." +
+ ++ ++ +Small and large animation files (
.BMPformat) for Navigator animated logo ++ + ++ +Convert the small and large
.BMPfiles to.GIFformat animation files. ++ +For information on incorporating these files into your Mozilla 1.4.1 installer, see Chapter 5 "Preparing to Customize the Mozilla Browser." +
+ ++ ++ + ++ +You must rename the file to
bookmarks.html. ++ +For information on incorporating this file into your Mozilla installer, see Chapter 5 "Preparing to Customize the Mozilla Browser." +
+ ++ ++ + ++ ++ ++ + ++ +No changes are necessary. +
+ +For information on incorporating this file into your Mozilla 1.4.1 installer, see Chapter 5 "Preparing to Customize the Mozilla Browser." +
+ ++ ++ + ++ ++ ++ + ++ + ++ ++ + +
+ + ++ +For the latest online version of this guide, which is updated periodically, see the following: +
++ +
+- +HTML version:
http://home.netscape.com/eng/mozilla/ns62/CCKDocs/guide.html+ +
+ +- +PDF version (easiest for printing):
http://home.netscape.com/eng/mozilla/ns62/CCKDocs/pdf/+ +
++ +Start by reading these two chapters: +
++ +
+- +Chapter 1 "Getting Started" describes the system requirements for running the CCK tool and basic information about using it. + +
+ +- +Chapter 2 "Customizing Mozilla in Ten Minutes" describes how to make the simple customizations listed above and create a Windows installer. Even if you want to make some of the other complex customizations described in the rest of this document, this chapter can help you get acquainted with the CCK tool quickly. + +
++ +If you are making only the simplest customizations described in Chapter 2, you can skip to Chapter 12 or Chapter 13 (see below). +
++ +If you need more information about any CCK tool screen or if you wish to use the CCK tool to make additional customizations that require some file preparation, read the following chapters: +
++ +
+- +Chapter 3 "Using the Configuration Workspace for Customized Files" describes the contents of the configuration directory, the files you can customize, and where to store them for easy access when you run the CCK tool. + +
+ +- +Chapter 4 "Preparing Platform and Installer Information" describes how to choose a platform and specify other basic information about your installer. + +
+ +- +Chapter 5 "Preparing to Customize the Mozilla Browser" describes the information and files you need to prepare for customizing different aspects of Navigator, the Mozilla browser. + +
+ +- +Chapter 6 "Preparing to Customize Mozilla Mail and News" describes the information you need to have on hand if you want customize your default domain and server settings for Mozilla Mail and Newsgroups. + +
+ +- +Chapter 8 "Preparing to Customize the CD Autorun Screen" describes the information and files you need to prepare in order to customize the CD autorun screen with the CCK tool. + +
+ +- +Chapter 9 "Preparing to Create the Installer" describes the Mozilla components you can choose to include in your installer and the requirements for additional installers you may wish to create. + +
+ +- +Chapter 10 "Verifying Your CCK Tool Customizations" describes how to verify the customizations you have made with the CCK tool. + +
++ +After you have verified all the customization you have made with the CCK tool, you can make additional manual customizations if you wish: +
++ +
+- +Chapter 11 "Manually Customizing the CD Autorun Screen" describes the manual customizations you can make, if you wish, to the CD autorun screen by manipulating the installation files generated by the CCK tool. + +
+ +- +Chapter 12 "Advanced Mozilla Customizations" provides an overview of the preferences architecture and the general procedure for manual customization, as well as detailed, step-by-step instructions for some of the most common manual customizations. + +
++ +After you have completed and verified all your manual customizations, follow the instructions in these chapters that apply to your situation: +
++ +
+- +Chapter 13 "Preparing Macintosh Installers and Program Files" describes how to create a Macintosh installer from the Windows installation files you generated with the CCK tool. + +
+ +- +Chapter 14 "Distributing Your Installers" describes how to prepare your customized installation files for CD or online distribution. + +
++ +Two appendixes provide additional practical information for ISPs: +
++ +
+- +Appendix A "Resources for ISPs" provides links to information for ISPs + +
+ +- +Appendix B "Manual Account Setup" summarizes the minimum information your customers need to set up their own accounts for your ISP business on Windows. + +
+ +- +Appendix C "Mozilla Profile Locations by Platform" summarizes the location of Mozilla profile directories on different platforms. + +
++ + +Where to Go for Related Information +
+ + ++ +Before using the CCK tool or this guide, be sure to check the latest Mozilla 1.4.1 Client Customization Kit Release Notes and sign up for the Browser Distribution Program. +
++ +For the latest online version of this guide, which is updated periodically, see the following: +
++ +
+- +HTML version:
http://bogus.url+ +
+ ++ +For information on third-party software and distribution solutions, see: +
+
+
+ +http:www.netscapetogo.com + +++ +For links to information on setting up an ISP, see Appendix A "Resources for ISPs." +
+ + +
++ + + + + diff --git a/mozilla/cck/CCKDocs/profile_appx_cck.htm b/mozilla/cck/CCKDocs/profile_appx_cck.htm new file mode 100644 index 00000000000..e3ed6a3cc9a --- /dev/null +++ b/mozilla/cck/CCKDocs/profile_appx_cck.htm @@ -0,0 +1,476 @@ + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + |
+
++ + + + +
++ + + +Appendix C + + + + + + + +Mozilla Profile Locations by Platform +
++ +By default, Mozilla profiles are stored in different places on different platforms. Users may also choose a directory or folder in which to store their profile data. +
++ +The directories shown in Table C-1 are the defaults for profile and registry storage. Paths to the
+Mozilladirectory vary among platforms. Themozilladirectory always contains the following: ++ +
+- +The profile registry (name varies among platforms) + +
+ +- +A directory called
Profiles+ +
++ +The Profiles directory contains one or more directories whose names correspond to Mozilla profiles (shown as profile_name in Table C-1). Each of these directories includes another directory whose name is composed of random numbers and letters (shown as salted_name in Table C-1). +
++ +Important: The directory
+Application Datamay be hidden on some Windows platforms (such as Windows 2000). If this is the case, the user should follow these steps to see it: ++ +
+ +- +Open the View menu for the Mozilla directory and choose Options. + +
+ +- +Click the View tab. + +
+ +- +Under Hidden Options, click "Show all files". + +
++ + +Table C-1 Locations of Mozilla profile information on different platforms +
+ + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/proxy_cck.htm b/mozilla/cck/CCKDocs/proxy_cck.htm new file mode 100644 index 00000000000..13f9fcd6d0e --- /dev/null +++ b/mozilla/cck/CCKDocs/proxy_cck.htm @@ -0,0 +1,351 @@ + + + + + + + + +
+
+ + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 7 + + + + + +Preparing to Customize Proxy Configurations +
+ +The CCK tool includes a screen called Customize Proxy Configurations that specifies the same settings available in the Advanced/Proxies section of the Mozilla 1.4.1 Preferences dialog box. +
++ +This chapter contains these sections: +
++ +About Proxy Configurations
+
Default Network Proxy Configurations ++ + +About Proxy Configurations +
+ + ++ +Many organizations block access from the Internet to their networks. This prevents outside parties from gaining access to sensitive information. The protection is called a firewall. +
++ +If your organization has a firewall, the browser may need to go through a proxy server before connecting your users to the Internet. The proxy server prevents outsiders from breaking into your organization's private network. +
++ + +Default Network Proxy Configurations +
+ + ++ +The CCK tool allows you to choose among the proxy configuration options listed below. They are identical to the options available in the Advanced/Proxies section of the Mozilla 1.4.1 Preferences dialog box. To see this section: +
++ +
+- +Open the Edit menu and choose Preferences. + +
+ +- +Click the Advanced category. If no subcategories are visible, double-click the category to expand the list. + +
+ +- +Click Proxies. + +
++ +These are the default options for the Proxies preferences panel that you can set in the CCK tool: +
++ +
+ + +- +Direct connection to the Internet. Choose this option if your users don't have to go through a proxy. + +
+ +- +Manual proxy configuration. Choose this option if your users don't have a proxy configuration file. Type the name or numeric IP address of the proxy server for HTTP and FTP. Type each proxy server's port number in the Port field. + +
++
+ +- +In the "No Proxy for:" field, type the names of any domains that your users can connect to directly, bypassing the proxy. For example, if you type
mozilla.org, then the proxy is bypassed each time your users view a web page from mozilla.org. +
- +Domain names are the part of a URL that contains the name of an organization, business, or school—such as
mozilla.orgorwashington.org. If you use local host names without the domain name, list them the same way. Use commas to separate multiple host names. The wildcard character [*] cannot be used. +
- +Automatic proxy configuration URL. Choose this option if you have a proxy configuration file. + +
+
++ + + + + diff --git a/mozilla/cck/CCKDocs/setup_appx_cck.htm b/mozilla/cck/CCKDocs/setup_appx_cck.htm new file mode 100644 index 00000000000..3fb6218c184 --- /dev/null +++ b/mozilla/cck/CCKDocs/setup_appx_cck.htm @@ -0,0 +1,728 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2001 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Appendix B + + + + + + + +Manual Account Setup +
++ +Once your customers have installed Mozilla from a CD or over the network, they need further instructions for setting up and using their ISP account. +
++ +This appendix summarizes the minimum information you need to give your dial-up customers as part of their manual Account Setup instructions for Windows NT. You can use it as a starting point in developing your own detailed instructions for use by your customers on various operating systems. +
++ +This appendix contains these sections: +
++ +Preliminaries
+
Set Up the Dialer
Create a Modem Location
Set Up TCP/IP
Log On and Start Mozilla +
+ + ++ +Before installing Mozilla and performing the setup tasks described in this appendix, a customer typically contacts the ISP, provides billing information, and fulfills any other requirements for setting up an account, such as creating a new user name and password. +
++ +In addition to installation instructions and other preliminary information, the ISP must provide a complete set of instructions describing what configuration tasks the user needs to perform after installing the Mozilla software, such as configuring the system and browser software, connecting with the ISP, and logging on. +
+
+ + ++ +Exact dialer setup instructions vary depending on the dialer software you want your customers to use and the modems they have installed. +
++ +For example, users can follow these instructions to set up the Dial-Up Networking utility provided with Windows NT: +
++ +
+- +Open the My Computer icon on the Windows NT desktop and double-click the Dial-Up Networking icon. + +
+ +- +Click New. + +
++
+ +- +The New Phonebook Entry Wizard appears. Fill in the requested information, clicking Next after you complete each screen. The titles of the Wizard screens are given in boldface in the instructions that follow. +
- +New Phonebook Entry Wizard: + +
++
+ +- +Name the new phonebook entry: +
- +(Example: MyISP)_____________________________________________________ +
- +Server: + +
++
+ +- +Select the following checkboxes: +
- +_____I am calling the Internet. +
- +_____Send my plain text password if that's the only way to connect. +
- +_____The non-NT server I am calling expects me to type login information after connecting, or to know TCP/IP addresses before dialing. +
- +Phone Number: __________________________________________ + +
++
+ +- +When you fill in the dial-in phone number and click Next, you see the last New Phonebook Entry Wizards screen. +
- +Click Finish in the last Wizard screen. + +
+ +- +Click Close in the main Dial-Up Networking screen. + +
++ + +Create a Modem Location +
+ + ++ +Exact modem setup instructions vary depending on the modem your customer is using. The instructions that follow assume that the user is has previously installed and configured a modem. For information on these tasks, see Windows NT Help. +
++ +Your users must have an appropriate Location set up for their modems to work correctly with your service. For example, they can follow these steps to set up appropriate Location information for use with an installed modem: +
++ +
+- +Open the Start menu and choose Control Panel. + +
+ +- +Double-click the Modem control panel. + +
+ +- +Click Dialing Properties. + +
+ + +- +Click New. + +
+ + +- +Type the name of your location (Example: San Francisco). + +
+ +- +Select the appropriate region from the drop-down list labeled "I am in this country/region:" (Example: United States of America). + +
+ +- +Fill in all relevant information about your phone line, including area code, access to an outside line, long distance calls, call waiting, tone versus pulse dial, and calling card information. + +
+ +- +Click OK. + +
+
+ + ++ +On Windows, you can access TCP settings through the Network control panel. To configure these settings: +
++ +
+- +Click Start, then Settings, then Control Panel, and double-click the Network control panel. + +
+ +- +Click the Protocols tab. + +
+ +- +Double-click TCP/IP Protocol. + +
+ +- +In the IP Address tab, select the adapter for the modem you will be using and select one of these options: + +
++
+ +- +_____Obtain an IP address from a DHCP server. This option is typically used with dial-up connections. +
- +_____Specify an IP address. If you are assigning an IP address to the user, select this option and provide the following information: +
- +IP address (Example: 000.000.000.000)___________________________________ +
- +Subnet mask (Example: 000.000.000.000)_________________________________ +
- + Default gateway (Example: 000.000.000.000)______________________________ +
- +Click the DNS tab and enter the following information: + +
++
+ +- +Host name (Example: myisp.net)_______________________________________ +
- +Domain (Example: www.myisp.net)_____________________________________ +
- +DNS Service Search order
Click Add to add each of these DNS Service Search Order entries: +
+
+- +(Example: 000.000.000.000)____________________________________________ +
- +(Example: 000.000.000.000)_____________________________________________ +
- +(Example: 000.000.000.000) __________________________________________ +
- + Domain Suffix Search Order: +
- +Click Add to add each of these DNS Suffix Search Order entries: +
+
- +Click the WINS Address tab and enter the following information: + +
++
+ +- +Primary WINS Server (Example: 000.000.000.000)________________________ +
- +Secondary WINS Server (Example: 000.000.000.000)______________________ +
- +____Enable DNS for Windows Resolution +
- +____Enable LMHOSTS Lookup +
- +Click OK, then click OK again. When asked if you want to restart your computer, click Yes. + +
++ + +Log On and Start Mozilla +
+ + ++ +Once your users have entered the settings described in the preceding sections, they are ready to dial up your service, log on, and start Mozilla. +
++ +Here are some sample instructions that use the Dial-Up Networking utility provided with Windows NT: +
++ +
+- +Open the My Computer icon on the Windows NT desktop and double-click the Dial-Up Networking icon. + +
+ +- +Select the ISP phonebook entry that you set up earlier. (Instructions for creating this entry are provided in "Set Up the Dialer.") + +
+ + +- +Click Location. + +
+ + +- +Select the location you set up earlier. (Instructions for creating this entry are provided in "Create a Modem Location.") + +
+ +- +Fill in any necessary prefix or suffix information as appropriate for your phone line. + +
+ +- +Click OK. + +
+ +- +Click Dial. + +
+ + +- +Enter the following information: + +
++
+ +- +User name (Example: joe@myisp.net)____________________________________ +
- +Password (Example: joe@myisp.net)_____________________________________ +
- +Domain: (Example: MYISP)____________________________________________ +
- +____Save password +
- +Click OK. + +
++ +After your users have logged on successfully, they follow the steps below to start using your customized version of Mozilla. +
++ +
+- +Open the Start menu and choose Programs, then + +
++
+ +- +(Example: Mozilla by MyISP)_______________________________________ +
- +then Mozilla. +
- +Note: If you have customized the Welcome screen—that is, the URL that the browser window displays when a new user starts Mozilla for the first time— you can use it to convey additional account setup details or other information you want your new users to read. +
- +Open the Tasks menu and choose Mail & Newsgroups. + +
+ + +- +Select the following radio button and click Next: + +
+ + +- +Enter the following information and click Next: + +
++
+ +- +Your Name (Example: John Chapman)___________________________________ +
- +Email Address (Example: chapman@myisp.net)___________________________ +
- +Verify that the information summarized by the Wizard is correct, and click Finish. + +
+ ++ +You should provide similar instructions for setting up a newsgroups account. +
+ + +
++ + + + + diff --git a/mozilla/cck/CCKDocs/verify_tool_cck.htm b/mozilla/cck/CCKDocs/verify_tool_cck.htm new file mode 100644 index 00000000000..ac1649188c2 --- /dev/null +++ b/mozilla/cck/CCKDocs/verify_tool_cck.htm @@ -0,0 +1,559 @@ + + + + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated October 05, 2001
+
|
+||
|
+ + + + + + + + + + + + + + + + + |
+
++ + + + +
++ + + +Chapter 10 + + + + + +Verifying Your CCK Tool Customizations +
+ +After you run the CCK tool, you should install your customized version of Mozilla 1.4.1 and verify that your customizations have taken effect correctly. If you want to make any adjustments, you can run the CCK tool again and produce a modified installer in the same output directory. +
++ +Important: Verify and finalize your CCK tool customizations before you make any manual customizations. If you have to run the CCK tool again after making manual customizations to your installation files, the tool will erase all your manual customizations. +
++ +This chapter contains these sections: +
++ +Installing Your Customized Build
+
Verifying Your Browser Customizations
Verifying Your Mail and News Customizations
Verifying Your Installer Customizations ++ + +Installing Your Customized Build +
+ + ++ +After the CCK tool has generated your custom installer, follow these steps to install your customized build: +
++ +
+- +On Windows, open the directory + +
++
+ +- +and double-click the file
setup.exe. +
- +On Linux, transfer the tar file from +
- +to a Linux system, extract the contents, and change the permission of the file
mozilla-installer-binto include executable permission. You can then run the install script by typing./mozilla-installer. +
- +If you decided to include a CD autorun screen with your installer, verify that it appears and that it reflects any customizations you made with the CCK tool. + +
+ +- +If you have a preexisting profile installed, create a new profile for testing purposes. To do so, click Manage Profiles when the Profile Manager appears, then click Create Profile. + +
+ ++ + +Verifying Your Browser Customizations +
+ + ++ +While running a new, unmodified Mozilla profile, verify the following: +
++ +
+- +The Windows Start menu includes your customizations to the Mozilla Program Folder. + +
+ +- +The Help menu includes the menu item that you specified and the new menu item points to the URL you specified. + +
+ +- +The Bookmarks menu and Personal Toolbar include your customizations. + +
+ +- +The Navigator browser's home page and Home button are set to the URL you specified. + +
+ +- +Your customized title bar text appears in the browser window's title bar. + +
+ +- +Your customized animated logo (static and animated versions) appears in place of the Mozilla logo, and clicking the animated logo button brings you to the URL you specified. + +
+ +- +Changes you made to My Sidebar appear when you first launch Mozilla. + +
+ +- +Changes you made to your proxy settings. + +
++ + +Verifying Your Mail and News Customizations +
+ + ++ +While running a new, unmodified Mozilla profile, follow these steps to verify your Mail & Newsgroups customizations: +
++ +
+- +Open the Tasks menu and choose Mail & Newsgroups. + +
++
+ +- +The first New Account Setup screen appears. Verify that the Mail and Newsgroup provider name that you specified with the CCK Tool show up correctly. +
- +Select your customized mail account and click Next. + +
++
+ +- +The second New Account Setup screen appears. Verify that the domain name you specified for the mail account shows up correctly. +
- +Click Finish. + +
+ + +- +Open the Edit menu and choose Mail & Newsgroups Account Settings. + +
++
+ +- +Click the name of the new mail account and examine the settings, then do the same for Server and Outgoing Server. Verify that the domain name, display name, account name, and server settings that you specified with the CCK tool all show up correctly. +
- +Click New Account and follow steps 1 through 4, except this time set up a new newsgroup account and checking the corresponding customizations. + +
++ + +Verifying Your Installer Customizations +
+ + ++ +While running any Mozilla profile, verify that only the components you selected in the final screen of the CCK tool are available. At a minimum, you should perform the checks described here as appropriate for each platform. See Table 9-1 (page 100) for details on platform support for each component. +
++ +Verify the presence of the optional components you selected as follows:
+
+
+
++ + + + + diff --git a/mozilla/cck/CCKHelp/bookmarks.html b/mozilla/cck/CCKHelp/bookmarks.html new file mode 100644 index 00000000000..8f9609c9730 --- /dev/null +++ b/mozilla/cck/CCKHelp/bookmarks.html @@ -0,0 +1,71 @@ + + + + + +
+
+ + + + + + + + + + + + + + + +
+Copyright © 2003 Netscape Communications Corp. All rights reserved.
+
+Last Updated July 30, 2001
+
Your customized bookmarks appear only
+in new profiles. When users launch your customized Mozilla browser using
+an existing profile, the browser uses the bookmarks file associated with
+that profile.
+
+
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Next. Each time you click Next +in a CCK screen, the information you entered or changed on that screen +gets automatically saved with the selected configuration. +
Exit. Click this button to exit +the CCK Tool. The customizations you have specified on any preceding screens +will be saved, but information you have specified on the current screen +will not. +
7/30/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/brandingpage1.html b/mozilla/cck/CCKHelp/brandingpage1.html new file mode 100644 index 00000000000..e2dbcf970e0 --- /dev/null +++ b/mozilla/cck/CCKHelp/brandingpage1.html @@ -0,0 +1,105 @@ + + + +
+ +Part One also allows you to add a menu +item to the Help menu and specify a URL for it. +
For complete information on how to +prepare the files required for the browser customizations specified by +these three screens, see the Guide to Customizing and Distributing Mozilla +1.4.1 +
Click the Show Example buttons to see +examples of the corresponding customizations. +
Logo Button URL. Enter the complete +URL for the page you want your users to see when they click your custom +animated logo button in the browser. +
Path to Your Animated GIF File (32 +x 32 pixels). If you've stored your animated GIF file somewhere other +than the location shown, click Choose File, browse to the location of the +file, and click Open. To check the file that's currently specified, click +the View File button. +
Path to Your At Rest GIF File (32 +x 32 pixels). If you've stored your static GIF file somewhere other +than the location shown, click Choose File, browse to the location of the +file, and click Open. To check the file that's currently specified, click +the View File button. +
Help Menu Item URL. Enter the +complete URL for the page you want your users to see when they choose your +custom Help menu item. +
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Next. Each time you click Next +in a CCK screen, the information you entered or changed on that screen +gets automatically saved with the selected configuration. +
Exit. Click this button to exit +the CCK Tool. The customizations you have specified in any preceding screens +will be saved, but information you have specified on the current screen +will not. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/brandingpage2.html b/mozilla/cck/CCKHelp/brandingpage2.html new file mode 100644 index 00000000000..85d3d73d72a --- /dev/null +++ b/mozilla/cck/CCKHelp/brandingpage2.html @@ -0,0 +1,99 @@ + + + +
+ +If you decide to customize the CD autorun screen, you should prepare +the bitmap and text filees required before using CCK to specify their location. +For detailed information on preparing these files, see the Guide to +Customizing and Distributing Mozilla 1.4.1. +
Click the Show Example buttons to see examples of the corresponding +customizations. If you want to customize the CD autorun screen in ways +that aren't shown here, such as adding more screens or files, see the Guide +to Customizing and Distributing Mozilla 1.4.1. +
Display This Text Below the Title Bar. Enter the text you want +to appear just below the title bar. For example: "Welcome to the Mach Networks +Installer for Mozilla 1.4.1." +
Path to Installation Text File (install.txt). If you've stored +your installation text file somewhere other than the location shown, click +Choose File, browse to the location of the file, and click Open. To check +the file that's currently specified, click the View File button. +
Feedback. Click this button to go to a web page where you can +provide feedback about the CCK Tool. +
Next. Each time you click Next in a CCK screen, the information +you entered or changed on that screen gets automatically saved with the +selected configuration. +
Exit. Click this button to exit the CCK Tool. The tool saves +customizations you have specified in any preceding screens, but doesn't +save any information you have specified on the current screen. +
7/31/2003 +
Copyright © 1994-2003 Netscape Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/brandingpage4.html b/mozilla/cck/CCKHelp/brandingpage4.html new file mode 100644 index 00000000000..780e4bf1421 --- /dev/null +++ b/mozilla/cck/CCKHelp/brandingpage4.html @@ -0,0 +1,64 @@ + + + +
+ + +Customizing +the Installer Background Text +
+
Customizing +the Installer Background Text +
Customizing the installer background text is an +easy way to promote your company's identity, products, and services. You +can customize the Installer background text to include your own custom +text. +
To customize the Installer background text: +
2. Under Installer Background Text, enter the +text (for example, "your company name") as you want it to appear.
+
Choosing the +Default Sidebar Tabs +
Sidebar is a customizable frame in the Mozilla +browser that provides access to popular items such as the latest news and +weather, address book or buddy list, stock quotes, a calendar, and many +other items that you can add. The sidebar presents these items in tabs +that it continually updates. +
Mozilla comes with some sidebar tabs already
+set up, but you can customize the sidebar by adding, removing, and rearranging
+tabs for your users.
+
+
For more information creating, testing, +and distributing your installer, see "Preparing to Create the Installer" +and subsequent chapters in the Guide to Customizing and Distributing +Mozilla 1.4.1. +
When a user installs Mozilla, the +additional installers are automatically installed after the main Mozilla +installation completes. However, if a user chooses the Custom path when +installing Mozilla, it's possible to choose not to install the additional +components. +
For each component, you need to provide +this information: +
Component Path. Click Choose +File, browse to the location of the executiable file, and click Open. +
Component Description. Enter +a concise description of the component and what it does. Users see this +text if they choose to perform a custom installation. +
Component Size. Enter a number +of kilobytes that’s approximately three times the size of the actual executable +file you specify. This ensures that the installer will have enough room +to expand and install the program on the user’s hard disk. +
Show Config Info. Before you +build the installer, you should click this button and review your customizations +to ensure that everything is correct. +
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Build Installer. Click this +button to initiate the installer build process. After the installer has +been created, you should run it, verify all your customizations, and if +necessary run CCK again to make any corrections or additional customizations +that may be required. +
Exit. Click this button to exit +the CCK Tool. The customizations you have specified in any preceding screens +are saved. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/checklist.html b/mozilla/cck/CCKHelp/checklist.html new file mode 100644 index 00000000000..3dfd3be99a5 --- /dev/null +++ b/mozilla/cck/CCKHelp/checklist.html @@ -0,0 +1,125 @@ + + + +
+ +Guide to Customizing and Distributing Mozilla 1.4.1 provides
+detailed information about the CCK tool as well as information about additional
+customizations you can perform manually. You can find this document on
+the website:
+
+
Show Config Info. Click this button to see what customizations +you've already completed for the configuration whose name is currently +displayed to the left. +
New Configuration. Click this button to create a new configuration. +(You will need to do this if this is your first time running the CCK tool.) +Enter the name of your configuration in the Create New Configuration dialog +box and click Create New Configuration. The CCK tool then creates a new +directory using the name you entered for the new configuration. +
The CCK tool creates your new configuration directory in the location +
installation_directory\CCKTool\Configs\my_config +
where installation_directory +is the directory you specified while installing the tool, and my_config +is the configuration name you specified after clicking New Configuration +as described above. +
Within your new configuration directory, +the CCK tool automatically creates the Output and Workspace subdirectories. +The Output directory is where the CCK tool will create your customized +Mozilla installer. You can use the Workspace directory as a convenient +place in which to store your customized files. It contains the following +subdirectories: +
Create a Copy. Click this button +to create a copy of the currently selected configuration. This option lets +you create a new customized installer, based on an existing configuration, +without overwriting the existing configuration (similar to a "Save As" +operation). +
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Next. Each time you click Next +in a CCK screen, the information you entered or changed on that screen +gets automatically saved with the selected configuration. +
Exit. Click this button to exit +the CCK Tool. When you click this button on the first screen, none of the +information you may have specified will be saved. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/customizepage1.html b/mozilla/cck/CCKHelp/customizepage1.html new file mode 100644 index 00000000000..241c3c13e8e --- /dev/null +++ b/mozilla/cck/CCKHelp/customizepage1.html @@ -0,0 +1,87 @@ + + + +
+ +Click the Show Example buttons to see +examples of the corresponding customizations. +
+
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Next. Each time you click Next +in a CCK screen, the information you entered or changed on that screen +gets automatically saved with the selected configuration. +
Exit. Click this button to exit +the CCK Tool. The customizations you have specified on any preceding screens +will be saved, but information you have specified on the current screen +will not. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/customizepage3.html b/mozilla/cck/CCKHelp/customizepage3.html new file mode 100644 index 00000000000..4c415edb0e9 --- /dev/null +++ b/mozilla/cck/CCKHelp/customizepage3.html @@ -0,0 +1,111 @@ + + + +
+ +Click the Show Example buttons to see +examples of the corresponding customizations. +
Mozilla 1.4.1 by. Enter the name +you want to appear after the words "Mozilla 1.4.1 by" in the Programs submenu +of the Windows Start menu. For example, if your company name is Mach Networks, +you would type "Mach Networks" here so that program folder name that appears +in the menu is "Mozilla 1.4.1 by Mach Networks". +
You should customize or replace the +Read Me file before you use this screen to specify its location. For information +on preparing the Read Me file, see +Preparing a Customized Read Me File +in the Preparing a Customized Read Me File +in the Guide to Customizing and Distributing Mozilla 1.4.1. +
Path to Your Custom Read Me File. +If you've stored your new or edited Read Me file somewhere other than the +location shown, click Choose File and browse to the location of the file. +To check the file that's currently specified, click the View File button. +
Mozilla 1.4.1 comes with some sidebar +tabs already set up. To provide your own sidebar tab in your customized +browser, you first create a tab, which is simply an HTML document. For +more detailed information on this topic, see Creating Your Own Sidebar +Tab in the Guide to Customizing and Distributing Mozilla 1.4.1. +
Sidebar Tab Title. +Specify the name that you want to appear on your sidebar tab. +
Sidebar Tab URL. +Specify the path to the customized sidebar tab that you want to include +in your browser. +
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Next. Each time you click Next +in a CCK screen, the information you entered or changed on that screen +gets automatically saved with the selected configuration. +
Exit. Click this button to exit +the CCK Tool. The customizations you have specified on any preceding screens +will be saved, but information you have specified on the current screen +will not. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/info.html b/mozilla/cck/CCKHelp/info.html new file mode 100644 index 00000000000..71193abbf05 --- /dev/null +++ b/mozilla/cck/CCKHelp/info.html @@ -0,0 +1,129 @@ + + + +
+ +Click the Show Example buttons to see +examples of the corresponding customization. +
For detailed information about the +installer decisions you must make on this screen, see Deciding What Kinds +of Installers to Create in the Guide to Customizing and Distributing +Mozilla 1.4.1. +
The CD Autorun Screen appears when +the CD is inserted into a CD-ROM drive. +
The CD autorun screen is not available +for Linux installers. +
Network-Ready Installer. If +you plan to distribute a network-ready stub installer for Windows or Mac +OS 9, enter the complete URL for the FTP or HTTP download directory location +where you plan to post the Mozilla nstaller files, for example, ftp1.isp.com/Mozilla/download. +
Make sure the location of the FTP download +directory where you plan to post the Mozilla installer files for Windows +corresponds exactly to the FTP download directory URL you enter on this +screen. +
If you plan to distribute a customized +Linux installer over the network, you can do so only in "fat" form: the +user downloads the entire Linux tar file for Mozilla 1.4.1, unpacks it, +and runs an installer script. Don't enter any URL here if you are creating +a Linux configuration. +
If you plan to distribute customized +Mac OS X program files, you can do so only in compressed binary form: the +user downloads the compressed binary files, unstuffs them, and launches +Mozilla 1.4.1 directly. Don't enter any URL here if you are creating a Mac +OS X configuration only. +
The CCK tool automatically adds (CK-yourstring) +to the end of the user agent string for the customized version of Mozilla +7.0 that it produces, where yourstring consists of the company identifier +that you supply. This identifer must be no more than ten charcaters in +length. +
For example, if your company name is +Mach Networks, the resulting customized user agent string containing your +company identifier might be: +
Mozilla/5.0 (Windows;U;WinNT5.0;en-US;rv:1.4.1)Gecko/20030827 +(CK-Mach-Net) +
where you added +the company identifier "Mach-Net" using the CCK tool. +
You must customize +the user agent string. The CCK Tool will not allow you to proceed to the +next screen unless you provide a company identifier of 10 characters or +less. +
If you are preparing +several different customized versions of Mozilla, you may want to supply +a different user agent string for each one. +
Feedback. +Click this button to go to a web page where you can provide feedback about +the CCK Tool. +
Next. +Each time you click Next in a CCK screen, the information you entered or +changed on that screen gets automatically saved with the selected configuration. +
Exit. +Click this button to exit the CCK Tool. The customizations you have specified +in any preceding screens will be saved, but information you have specified +on the current screen will not. +
7/31/2003 +
Copyright © +1994-2003 Netscape Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/inst.html b/mozilla/cck/CCKHelp/inst.html new file mode 100644 index 00000000000..0009796e279 --- /dev/null +++ b/mozilla/cck/CCKHelp/inst.html @@ -0,0 +1,60 @@ + + + +
+ + +Customizing the background text that users see +when they run the Mozilla installer is an easy way to promote your company's +identity, products, and services. +
You can customize the installer background text +to include your own custom text. +
To customize the Installer background text: +
2. Under Installer Background Text, enter the +text (for example, "your company name") as you want it to appear.
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Build Installer. Click this +button to initiate the installer build process. After the installer has +been created, you should run it, verify all your customizations, and if +necessary run CCK again to make any corrections or additional customizations +that may be required. +
Exit. Click this button to exit +the CCK Tool. The customizations you have specified in any preceding screens +are saved. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/mailhelp.html b/mozilla/cck/CCKHelp/mailhelp.html new file mode 100644 index 00000000000..3ca94efe985 --- /dev/null +++ b/mozilla/cck/CCKHelp/mailhelp.html @@ -0,0 +1,105 @@ + + + +
+ +If you leave all the fields blank, the customized version of Mozilla +1.4.1 produced by CCK will not include any customized mail settings. +
For more information on customizing Mozilla Mail, see Preparing to +Customize Mozilla Mail and News in Guide to Customizing +and Distributing Mozilla 1.4.1. +
Click the Show Example buttons to see examples of the corresponding +customization. +
Display name. Enter the mail account name that you want to appear +as the Mail Folder in the left frame of the main Mozilla Mail screen. +For example, "Mach Networks Mail". +
Mail provider. Enter the text that you want to appear in the +New Account Setup screen, where users are prompted to select the type of +account that they would like to set up, such as a newsgroup, e-mail, or +Webmail. This screen includes a variety of options; choices include AOL +and Mozilla accounts, so the more specific you make this text, the more +helpful to your customer. For example, to be consistent with other choices +on this account setup list, you might enter a string such as "Macn Networks +Mail Account". +
Server name. Enter the name of the incoming server. For example: +machnet.mail.net +
Port number. Enter the port for the incoming server. The standard +port number is 110. +
Server type. Choose POP or IMAP. If you choose POP, you can also +choose to leave messages on the server even after the user deletes them +in the Mozilla Mail program. +
Feedback. Click this button to go to a web page where you can +provide feedback about the CCK Tool. +
Next. Each time you click Next in a CCK screen, the information +you entered or changed on that screen gets automatically saved with the +selected configuration. +
Exit. Click this button to exit the CCK Tool. The customizations +you have specified in any preceding screens are saved, but information +you have specified on the current screen is not saved. +
7/31/2003 +
Copyright © 1994-2003 Netscape Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/newshelp.html b/mozilla/cck/CCKHelp/newshelp.html new file mode 100644 index 00000000000..91224aa1f63 --- /dev/null +++ b/mozilla/cck/CCKHelp/newshelp.html @@ -0,0 +1,97 @@ + + + +
+ +If you leave all the fields blank, the customized version of Mozilla +1.4.1 produced by CCK will not include any customized News settings. +
For more information on customizing Mozilla News, see "Preparing to +Customize Mozilla Mail and News" in the Guide to Customizing and Distributing +Mozilla 1.4.1. +
Click the Show Example buttons to see examples of the corresponding +customization. +
Display name. Enter the News account name that you want to appear +near the bottom of the left frame of the main Mozilla Mail screen. For +example, "Mach Networks News". +
News provider. Enter the text that you want to appear in the +New Account Setup screen, where users are prompted to select the type of +account that they would like to set up, such as a newsgroup, e-mail, or +Webmail. This screen includes a variety of options; choices include AOL +and Mozilla accounts, so the more specific you make this text, the more +helpful to your customers. For example, to be consistent with other choices +on this account setup list, you might enter a string such as "Mach Networks +News Account". +
Server name. Enter the name of the News server. For example: +mach.news.net +
Port number. Enter the port for the News server. The standard +port number is 119. +
Feedback. Click this button to go to a web page where you can +provide feedback about the CCK Tool. +
Next. Each time you click Next in a CCK screen, the information +you entered or changed on that screen gets automatically saved with the +selected configuration. +
Exit. Click this button to exit the CCK Tool. The customizations +you have specified in any preceding screens will be saved, but information +you have specified on the current screen will not. +
7/31/2003 +
Copyright © 1994-2003 Netscape Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/platform.html b/mozilla/cck/CCKHelp/platform.html new file mode 100644 index 00000000000..d43ae16874d --- /dev/null +++ b/mozilla/cck/CCKHelp/platform.html @@ -0,0 +1,106 @@ + + + +
+ +For detailed information on generating a Mozilla installer for each +operating system, see "Preparing Platform and Installer Information" +in Guide to Customizing and Distributing Mozilla 1.4.1. +
Linux. To create a Linux installer, choose Linux from the drop-down +list and specify the location of the Linux tar file as described below. +
Macintosh. To prepare a Macintosh installer, you first use the +CCK tool to create a Windows installer, then follow the instructions in +"Preparing Macintosh Installers and Program Files" in Guide to Customizing +and Distributing Mozilla 1.4.1. +
If you are creating a Linux installer, +you must also have GNU Tools for Microsoft Windows (the Cygnus toolkit) +installed on the system before running the CCK tool. You can obtain the +Cygnus toolkit from http://www.cygwin.com/. +You must also make sure that the path to the binaries for the Cygwin Unix +programs is included in the Windows environment variable called PATH. To +check, open the System control panel and click the Environment tab. +
You need to specify the location of +the Linux tar file only once. After you do so, the CCK tool creates this +directory: +
installation_directory\CCKTool\nscpxpiLinux\ +
and stores the decompressed standard +Linux installation files there. +
After you finish running the CCK tool, +the tool creates the customized Linux build as a tar file in +
installation_directory\CCKTool\Configs\my_config\Output\ +
You can then transfer this tar file +to a Linux system and the extract the contents for testing. After you extract +the contents of the tar file, you must also change the permission of the +file mozilla-installer-bin to include executable permission. You can then +run the install script by typing ./mozilla-installer. +
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Next. Each time you click Next +in a CCK screen, the information you entered or changed on that screen +gets automatically saved with the selected configuration. +
Exit. Click this button to exit +the CCK Tool. When you click this button on the first screen, none of the +information you may have specified will be saved. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/proxy.html b/mozilla/cck/CCKHelp/proxy.html new file mode 100644 index 00000000000..d056fd35f03 --- /dev/null +++ b/mozilla/cck/CCKHelp/proxy.html @@ -0,0 +1,89 @@ + + + +
+ +If your organization has a firewall, +the browser may need to go through a proxy server before connecting your +users to the Internet. The proxy server prevents outsiders from breaking +into your organization's private network. +
Manual proxy configuration. +Choose this if your users don't have a proxy configuration file. Type the +name or numeric IP address of the proxy server for HTTP and FTP. Type each +proxy server's port number in the Port field. +
In the "No Proxy for:" field, type +the names of any domains that your users can connect to directly, bypassing +the proxy. For example, if you type "netscape.com", then the proxy is bypassed +each time your users view a web page from netscape.com. +
Domain names are the part of a URL +that contains the name of an organization, business, or school—such as +netscape.com or washington.org. If you use local host names without the +domain name, list them the same way. Use commas to separate multiple host +names. The wildcard character [*] cannot be used. +
Automatic proxy configuration URL. +Choose this if you have a proxy configuration file. Type the file's URL +in the field and click Reload. +
Feedback. Click this button +to go to a web page where you can provide feedback about the CCK Tool. +
Next. Each time you click Next +in a CCK screen, the information you entered or changed on that screen +gets automatically saved with the selected configuration. +
Exit. Click this button to exit +the CCK Tool. The customizations you have specified in any preceding screens +will be saved, but information you have specified on the current screen +will not. +
7/31/2003 +
Copyright © 1994-2003 Netscape +Communications Corporation. + + diff --git a/mozilla/cck/CCKHelp/shell1.html b/mozilla/cck/CCKHelp/shell1.html new file mode 100644 index 00000000000..dcd595e50e8 --- /dev/null +++ b/mozilla/cck/CCKHelp/shell1.html @@ -0,0 +1,134 @@ + + + +
+ + +If you plan to create Mozilla installers for +CD distribution, you can provide a CD Autorun screen that automatically +appears when the user inserts your customized Mozilla CD into their +CD-ROM drive. +
The CD Autorun screen makes it easy for your users +to install Mozilla or to read installation instructions before they +begin the installation process. +
The CCK tool provides a standard CD Autorun screen +that’s ready to use. To include the standard CD Autorun screen, you must +check the "Include CD Autorun Screen" check box in the CCK tool's "Gathering +Information" page. +
Customizing the standard CD Autorun screen is +optional. +
You might want to customize the CD Autorun screen's +background if you want to add your company logo or add other images that +promote your company's identity. +
The standard background image for the CD Autorun +screen consists of a 640 pixel by 480 pixel bitmap (.BMP) file. +
The easiest way to customize the background image +is to edit the existing background image, called install.bmp, as described +under Editing the Standard +Background Image. If you prefer, you can substitute your own custom +file as described under Creating +Your Own Custom Background Image. +
Editing +the Standard Background Image +
To edit the standard background image: +
C:\Program Files
+
\Mozilla\CCK\CCKTool\Configs\ configname
+\Workspace\Autorun\Shell\bmps
+
directory, where configname is the directory +name that corresponds to the configuration you are working with. +
2. Using a graphics editing program, open the +install.bmp file and make your changes to it. For example, you might want +to add your company's logo and name.
Do not add text or graphics +within the black border area at the bottom of the CD Autorun screen. This +area is reserved for the CD Autorun screen's Browse CD, Back, and Exit +buttons. +
3. Save your changes, making sure to save the +file in .BMP format. If you want, you can save the file using another name. +
4. In the CCK tool, go to the screen titled "Customize +the CD Autorun Screen." +
5. Under Background Bitmap, click Choose File +and browse to the location of your custom background image to include it.
To create your own custom background image for +the CD Autorun screen: +
Tip +
Keep the size of the file as +small as possible (325 Kbytes or less) by reducing the number of colors +in the file, or by removing or flattening the layers (if you created the +image in PhotoShop). If your file size is too large, it may not appear +in the CD Autorun screen. +
2. At the bottom of the background image, create +a rectangular border at least 40 pixels high and 640 pixels wide. The CD +Autorun screen will use this area to display the CD control buttons (Browse +CD, Back, and Exit).
C:\Program Files\Mozilla\CCK\CCKTool\Configs\ +configname \Workspace\Autorun\Shell\bmps +
directory, where configname is the directory +name that corresponds to the configuration you are working with. +
4. In the CCK Tool, go to the screen titled "Customize +the CD Autorun Screen." +
5. Under Background Bitmap, click Choose File…
+and browse to the location of your custom background image to include it.
+
The CD Autorun screen is a +great place to identify your company name, since users automatically see +this screen when they insert the Mozilla CD into a CD-ROM drive. +
To include your own custom text on the CD Autorun +screen: +
1. In the CCK Tool, go to the screen titled "Customize +the CD Autorun Screen." +
2. Under Title Bar Text, enter the text (for example, +your company name) as you want it to appear in the screen’s title bar and +in the area below the title bar of the CD Autorun screen. +
The text you enter for the title bar will be appended
+to the words "Mozilla by".
+
+
07/31/2003 + + diff --git a/mozilla/cck/CCKHelp/shell4.html b/mozilla/cck/CCKHelp/shell4.html new file mode 100644 index 00000000000..82491da8960 --- /dev/null +++ b/mozilla/cck/CCKHelp/shell4.html @@ -0,0 +1,76 @@ + + + +
+ + +The CD Autorun screen includes a button that, +when clicked, opens a text document that contains instructions for installing +Mozilla. You might want to include additional information in this document +that you want your users to know before they install Mozilla. +
For example, you could add information on your +products and services, and tell users how they can contact you for more +information. If you're planning to include installers for additional programs +as part of your Mozilla installer, this document is a great place to +tell your users about the additional programs you're providing. +
To edit the installation document: +
2. Make a copy of this file and save it in your +C:\Program Files\Mozilla\CCK\CCKTool\Configs\ configname \Workspace\Autorun +directory, where configname is the directory name that corresponds +to the configuration you are working with. +
3. Open the install.txt document using a standard +text editor, such as Wordpad. +
4. Edit the install.txt document and save your +changes. +
5. In the CCK Tool, go to the screen titled "Customize +the CD Autorun Screen." +
6. Under Custom Installation Text File, click +Choose File… and browse to the location of your custom install.txt file +to include it.
+
+
+
+
+
+
+
+