The description: "Opera Page Saving plug-in".

If you use Opera then you have probably noticed that this browser saves web pages differently than IE – it just piles them up. I find it inconvenient and not nice at all. Having looked around the Internet a programm or plug-in helping Opera to save pages appropriately I found nothing of the kind. I decided to write my own which could save pages in any format you like. And here it is

This programm replaces Opera save dialog with extended one by COCO. Using this dialog window you can:

• Save web pages in various formats using appropriate plug-in modules. For example to save page in “chm” format you shall have htm2chm programm installed (I recommend to use version 1.5 which can be downloaded on my site).
• Save pages in separate folders named automatically according to file name.
• Name files automatically using various macrostrings.
• Use quick save mode – in this mode page will be saved in predefined folder without showing save dialog.
• Switch quickly to your favourite folders in save dialog window.
• Log history of pages saved.
• Create special info file in the saved page folders containing information about the pages saved.
• Add some information in source page code (e.g. commentary, adress, date etc.).
• Use system of macro commands to make your own save scenarios.

From version 2.2 and on COCO will be distributed in 2 type of packages, which differ from each other only by presence of the installation programm.

Installation using installer Run file COCOSetup.exe and follow the instructions.

Installation without installer Extract the files from archive into Opera’s folder i.e. C:\opera760\COCO\.

From version 2.3 and on COCO can be adjusted only by using windows-based interface. It can be done by running COCO.exe without parameters. Programm settings consist of several sections indicated as a list in the left part of the window (similar to Opera settings window).

here you can add/remove/adjust actions which will be done after page is saved. E.g. packing into an archive.

• Default - the default method of page saving. It is also used for quick save mode.
• Remember - check this flag if you want COCO to remember the last save method used in save dialog window.
• Name - the name of save method shown in save dialog.
• Script file name - The name of the script file. Script files shall be placed in COCO’s ‘script’ subfolder.
• File type - file extension for save action according to chosen script file.
• Path to compiler - complete path to the program responsible for convertation of pages saved.
• Add comments in page code - check this flag is you want COCO to add some additional information in the source page code.
• Create description file “.ion” - check this flag if you want COCO to create “description.ion” file containing additional info in the folder when pages are saved.
• Show in save in COCO dialog - uncheck this flag if you don’t want to see this method in save dialog.
• Open when packed - check this flag if you want the saved file to be opened after being saved.

• File Name - macrostring used for filling in the filed “File name” of the save dialog.
• Comment - macrostring used for filling in the filed “Comments” of the save dialog.
• Detailed Comment - macrostring used for filling in the filed “Detailed Comment” of the save dialog which is used for adding in source page code or description.ion file (for line folding use “;” sign)

• Name - the button name.
• Command - for version 2.3 two coomands are available:
  1. Create folder – creates folder in the currently opened place naming it according to “Title” macrostring
  2. Open folder - jump to the folder specified in the field “Path”.

Use this option to adjust Opera for using COCO.

• Add Document PopUp Menu Item - check this flag to add command “Save...with COCO” to the web page popup menu.
• Add Main Menu Item - check this flag to add command “Save...with COCO” to Opera’s File menu.
• Add Main Bar Button - check this flag to add button “Save...with COCO” to Opera’s Main Bar.
• Add Document Bar Button - check this flag to add button “Save...with COCO” to Opera’s Document Bar.
• Hotkey ALT+S - check this flag to map ALT+S buttons for running COCO’s save dialog.
• Hotkey ALT+Q (Quick Save) - check this flag to map ALT+Q buttons for COCO’s quick save command.
• Integrate - press this button to apply changes.

The log of folders where web pages were saved.

• Use history - check this flag to use history storing mode (in this mode coco remembers last folders used for saving web pages).
• Max History Lines - Maximum number of folders to remember.
• Clear History - press this button if you want to clear history.

This mode lets you save pages in predefined folder at once without showing save dialog.

• quick Save Folder - full Path to the folder where Coco Saves web pages in quick Save mode. If this field is blank then Coco Uses last saving Session folder.

The different options which have not got in one other section.

• Interface Language - drop down button to choose CoCo’s dialog language settings.
• Temporary Files folder - is used for converting operations. If the field is left blank Coco uses folder defined in “TMP” system environment variable.
• Show comment field in Save dialog - check this flag if you want to add your Comments While saving pages.
• Place Coco’s save dialog centered in Opera WINdow - establish a daw if wish to see a window of preservation always on one place - on the center.
• Date format - the template used for %date% macrostring. (see The appendix)
• Time format - the template used for %time% macrostring. (see The appendix)

Script file is a common batch file with “bat” extension used for compatibility with older Windows versions. It’s name and corresponding save method name shall completely coincide. The following variables can be used in the script:

• %1 - The full path to the destination folder for saving page (shall be ended with “\” sign)
• %2 - Filename to save (without extension)
• %3 - The full path to the source folder – the initial COCO saving folder named according to the page being saved (shall be ended with “\” sign)
• %4 - The full file extension (e.g. “.htm”)
• %5 - The full original page extension (e.g. “.html”)
• %6 - The full path to compiler

At use %X where X - number of parameter, value will be substituted so-called, and at % ~X - without inverted commas.

From version 2.3 and on COCO supports multilanguage interface. You can modify existing language profiles or add your own. *.lng-file is a simple text file. Each row starting with “^” coinsides the text in COCO dialog. The others can be used for comments.

Structure for user contributed language file:

• Dialog – a numerical code of the dialog being translated =
  1. Save Dialog
  2. Miscellaneous Settings
  3. Custom Buttons Settings
  4. History Settings
  5. Integration Dialog
  6. Macrostrings settings
  7. Quick Save Settings
  8. Save Methods Settings
  9. Settings Window
  10. Save flash files dialog
  11. Dialogue “About the program”
• Code - system handler for COCO’s interface elements
• Text* - The name of the interface element - plain text – 1 line corresponds to 1 element.

If you use Opera 7.x and above then you can customize popup menus, toolbars and even keyboard shortcuts. First you need to know where is the Opera located (normally C:\Program Files\Opera7). From here and on instead of putting the full path to Opera the contraction “%opera%” is used (you need to put your full path instead it). If you didn’t make adjustements in Opera setting files then they can be found in %opera%\defaults\ folder.

Opera popup menu customisation:

Open your Opera menu settings file named “standard_menu.ini” or your own menu file usually located in %opera%\profile\menu\ folder and add line “Item, “Save...with images”=Execute program, “C:\opera760\COCO\coco.exe”, “%t^^%c^^%u^^true^^”, 50977, “Save” & Save document with images as” in the [Document Popup Menu] section. This adds “Save document with images as” item to Opera page popup menu.

Opera hotkeys customisation:

Open your Opera keyboard settings file named “standard_keyboard.ini” or your own keyboard settings file usually located in %opera%\profile\keyboard\ folder and add line “s alt=Execute program, “C:\opera760\COCO\coco.exe”, “%t^^%c^^%u^^true^^”, 50977, “Save” & Save document with images as” in the [Application] section. This lets you use “Alt+S” combination to call COCO save dialog.

Opera toolbar customisation:

Open your Opera toolbar settings file named “standard_toolbar.ini” or your own toolbar settings file usually located in %opera%\profile\toolbar\ folder and add line “ButtonN, “Save in COCO”=Execute program, “C:\opera760\COCO\coco.exe”, “%t^^%c^^%u^^true^^”,”Save in COCO” ,”Save” & Save document with images as” in the [Document Toolbar.content] section. This lets you use Button on Page panel to call COCO save dialog.

You can add any items you like to Opera settings but you shall be consistent with COCO call procedure format: ...\coco.exe %t^^%c^^%u^^true, т.е ...\coco.exe selected_text^^ clipboard^^page_address^^show_dialog^^

show_dialog – this logic variable defines whether to show save dialog (true) or not (false):

Please send me your suggetions, feedbacks and bug reports. You can contact me using e-mail bivsoft@mail.ru Please include in the subject field word “COCO”. If you make your own scripts for saving pages using COCO send it to me for including in package with your copyright. Please use the same e-mail for this purpose.

-/+/* = removed/added/changet

2.3 betta 5, 18-10-2005

 [+] save of all open windows (to read session.cfg)
 [+] the separate utility of integration
 [+] save format "Alternative IE"
 [+] save format "Alternative IE" + folder
 [+] save format "only HTML" in two ways ;)
 [+] save command in specified a format for "fast buttons"
 [+] transition from dialogue of adjustments automatically
     in dialogue of preservation if the call has occured from the last
 [+] an opportunity of a choice иконок at integration
 [*] it is completely latent a console window of processing
 [*] at a choice of a format of preservation or change of a folder
     the name of a file delete
 [*] replacement of variables in all scripts of processing %1 on % ~1
 [*] at attempt of transition to a nonexistent folder from history or
     "fast buttons" - transition to the nearest existing
 [*] reaction to a mistake of the incorrect instruction of
     macrovariables the user
 [*] incorrect comparison of " the hot button " to item of the menu of
     the Opera
 [*] the order of following in new style of "fast buttons"
 [*] storing of a way to time паке even if there was an empty line
 [*] the mistake "section is not found"
 [*] installation of language of the interface of the user
     chosen during installation
 [*] replace $data$-$date$, $bufer$-$buffer$, $adres$-$address$
 [*] fine mistakes of the interface

2.3 betta 4, 16-08-2005

 [*] work in system with non-standard scale factor
 [*] the interface of dialogue of preservation is changed
 [*] an opportunity of preservation of frames in format IE
 [+] the expanded way of use of special buttons
 [+] compatibility of a file of options for all new versions
 [+] section "About the program"
    

2.3 betta 3, 22-06-2005

 [+] an opportunity of preservation in format Internet Explorer
 [+] sample change of a format of date and time
 [*] correction of a bug "the latent expansion"
 [*] the window of a script now is turned off
 [*] pair fine interface bugs

2.3 betta 2, 14-06-2005

 [+] the system of options, in result - reduction is advanced
     The size of an executed file and increase of speed.
 [+] the window of options is structured.
 [+] support of the utility 7zip.
 [+] an opportunity of a visual choice of the program of the packer.
 [+] start of page after preservation.
 [+] an opportunity of option of dialogue of preservation.
 [+] system of support of set of languages.
 [+] a macrovariable $user $.
 [*] dialogue of preservation one.
 [*] work with long headings
 [*] independence of visibility of expansion in system
 [*] replacement DIZ on ION
 [*] process of initial option and integration is simplified.
 [*] other fine corrections.
 [-] Full refusal of manual option.

2.2, 05-03-2005

 [+] инсталлятор 
 [+] visual option and integration
 [+] support of a mode of versatility
 [+] support of not Russified OS
 [+] conducting a history of preservation
 [+] system of additional buttons for transition to "favourite" folders
 [+] an opportunity of a choice of a way of preservation it is direct from dialogue
 [+] a script for preservation in format CHM
 [*] work with the Opera 8b

2.1, 22-02-2005

 [+] an opportunity to disconnect creation of a file .diz
 [+] automatic инкрементация a name of a file at concurrence
 [+] fast preservation in beforehand specified folder 
     (without dialogue of preservation)
 [*] a filtration on expansion for each of scripts

2.0, 10-02-2005

 The explanatory: it not release, figure 2 I would like to emphasize 
 Novelty of the version since the program has completely changed strategy 
 Works, we shall consider therefore, that it is a starting point in history.
 [+] the code is completely copied
 [+] system of scripts
 [+] system of macrolines
 [-] monitoring
 [-] dependence on foreign programs

1.0, 04-03-2004

 [+] Creation of the first pilot version. 

Format of patterns of time and date:

Translated by Ilya aka Chichako.