PART4: APPENDⅨ Appendix: The shared Folder The shared folder contents Using the shared folder 49 Index ontents 7
Contents 7 PART 4: APPENDIX Appendix: The Shared Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 The Shared folder contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 Using the Shared folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .491 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
8 Contents
8 Contents
Introduction This guide describes the Macromedia Dreamweaver 8 framework and application programming interface(APi) that lets you build extensions to Dreamweaver. It provides information about how each type of extension works; the API functions that Dreamweay calls to implement the various objects, menus, floating panels, server behaviors, and so on, that make up the features of Dreamweaver; and a simple example of each type of extension and XML files to add menu items or document types, and so n. ng tags in various To add an object, menu, floating panel, or other feature to Dreamweaver, you must code the functions that the particular type of extension requires. This guide describes the arguments that Dreamweaver passes to these functions and also the values that Dreamweaver expects these functions to return For information on the utility and general purpose JavaScript APls that you can use to perform various support operations in your Dreamweaver extensions, see the Dreamweaver API Reference. If you plan to create extensions that work with databases, you might also wan to review the sections in Getting Started with Dreamweaver about making connections to Background Most Dreamweaver extensions are written in HTML and JavaScript. This guide assumes that you are familiar with Dreamweaver, HTML, XML, and Java Script programming. If you are q. plementing C extensions, the guide assumes that you know how to create and use C ynamic link libraries(DLLs). If you are writing extensions for building web applications you should also be familiar with server-side scripting on at least one platform, such as Active Server Pages(ASP), ASPnet, PHP: Hypertext Preprocessor(PHP), Macromedia ColdFusion or Java Server Pages (SP)
9 Introduction This guide describes the Macromedia Dreamweaver 8 framework and application programming interface (API) that lets you build extensions to Dreamweaver. It provides information about how each type of extension works; the API functions that Dreamweaver calls to implement the various objects, menus, floating panels, server behaviors, and so on, that make up the features of Dreamweaver; and a simple example of each type of extension. This guide also explains how to customize Dreamweaver by editing tags in various HTML and XML files to add menu items or document types, and so on. To add an object, menu, floating panel, or other feature to Dreamweaver, you must code the functions that the particular type of extension requires. This guide describes the arguments that Dreamweaver passes to these functions and also the values that Dreamweaver expects these functions to return. For information on the utility and general purpose JavaScript APIs that you can use to perform various support operations in your Dreamweaver extensions, see the Dreamweaver API Reference. If you plan to create extensions that work with databases, you might also want to review the sections in Getting Started with Dreamweaver about making connections to databases. Background Most Dreamweaver extensions are written in HTML and JavaScript. This guide assumes that you are familiar with Dreamweaver, HTML, XML, and JavaScript programming. If you are implementing C extensions, the guide assumes that you know how to create and use C dynamic link libraries (DLLs). If you are writing extensions for building web applications, you should also be familiar with server-side scripting on at least one platform, such as Active Server Pages (ASP), ASP.net, PHP: Hypertext Preprocessor (PHP), Macromedia ColdFusion, or Java Server Pages (JSP)
Installing an extension To become familiar with the process of writing extensions, you might want to explore the extensions and resources that are available through the macromedia exchange website (www.macromedia.com/exchange).Installinganexistingextensionintroducesyoutosomeof the tools that you need to work with in your own extensions. To install an extension, use the following procedure 1. Download and install the Extension Manager, which is available on the Macromedia Downloadswebsite(www.macromedia.com/software/downloads) 2.loGontotheMacromediaExchangewebsite(www.macromedia.com/exchange) 3. From the available extensions, select one that you want to use. Click the Download link download the extension packag 4. Save the extension package in the Dreamweaver 8/Downloaded Extensions folder of installed Dreamweaver folder 5. In the Extension Manager, select File> Install Extension In Dreamweaver, select Commands >Manage Extensions to start the Extension Manager The Extension Manager automatically installs the extension from the Downloaded Extension folder into dreamweaver Some extensions need Dreamweaver to restart before you can use them. If you are running Dreamweaver when you install the extension, you might be prompted to quit and restart the application To view basic information on the extension after its installation, go to the Extension Manager (Commands > Manage Extensions) in Dreamweaver Creating an extension Before you create a Dreamweaver extension, visit the Macromedia Exchange website at www.macromedia.com/exchangetoseeiftheextensionyouplantocreatealreadyexistsIf you do not find an extension that meets your needs, you then perform the following steps m Determine the type of extension you want to create. For more information about the extension types, see "Types of Dreamweaver extensions"on page 100 a Review the documentation for the type of extension you plan to create. To become familiar with creating that type of extension, it's a good idea to create the simple extension example in the appropriate chapter
10 Introduction Installing an extension To become familiar with the process of writing extensions, you might want to explore the extensions and resources that are available through the Macromedia Exchange website (www.macromedia.com/exchange). Installing an existing extension introduces you to some of the tools that you need to work with in your own extensions. To install an extension, use the following procedure: 1. Download and install the Extension Manager, which is available on the Macromedia Downloads website (www.macromedia.com/software/downloads). 2. Log on to the Macromedia Exchange website (www.macromedia.com/exchange). 3. From the available extensions, select one that you want to use. Click the Download link to download the extension package. 4. Save the extension package in the Dreamweaver 8/Downloaded Extensions folder of your installed Dreamweaver folder. 5. In the Extension Manager, select File > Install Extension. In Dreamweaver, select Commands > Manage Extensions to start the Extension Manager. The Extension Manager automatically installs the extension from the Downloaded Extension folder into Dreamweaver. Some extensions need Dreamweaver to restart before you can use them. If you are running Dreamweaver when you install the extension, you might be prompted to quit and restart the application. To view basic information on the extension after its installation, go to the Extension Manager (Commands > Manage Extensions) in Dreamweaver. Creating an extension Before you create a Dreamweaver extension, visit the Macromedia Exchange website at www.macromedia.com/exchange to see if the extension you plan to create already exists. If you do not find an extension that meets your needs, you then perform the following steps to create the extension: ■ Determine the type of extension you want to create. For more information about the extension types, see “Types of Dreamweaver extensions” on page 100. ■ Review the documentation for the type of extension you plan to create. To become familiar with creating that type of extension, it’s a good idea to create the simple extension example in the appropriate chapter
u Determine which files you need to modify or create Plan the user interface(UD), if any, for the extension. Create the necessary files and save them in the appropriate folder Restart Dreamweaver so that it recognizes the new extension Test the extension m Package the extension so that you can share it with others. For more information,see Working with the Extension Manager on page 109 Additional resources for extension writers To communicate with other developers who are involved in writing extensions, you might want to join the Dreamweaver extensibility newsgroup. You can access the website for this atwww.macror What's new in Dreamweaver Dreamweaver 8 includes the following new features and interfaces that are extensible. Each of these features has new related functions, which are listed in the Dreamweaver API Reference m Improved site synchronization The comparison of local and remote files is more reliable in Dreamweaver 8. Copy and paste choices have been simplified. Users can also now set the default behavior of a paste operation to be to paste text only Site root-relative links mapping has been improved Code coll Dreamweaver now lets users selectively collapse or expand seg of code Code view toolbar Dreamweaver now provides a toolbar in Code view that allows quick access to commonly used commands This feature lets users to do other things in Dreamweaver while processing server-related tasks a File compare integration Dreamweaver now lets users launch a third-party file comparison application to compare two local files, two remote files, or the local and remote versions of a file What's new in Dreamweaver 11
What’s new in Dreamweaver 11 ■ Determine which files you need to modify or create. ■ Plan the user interface (UI), if any, for the extension. ■ Create the necessary files and save them in the appropriate folders. ■ Restart Dreamweaver so that it recognizes the new extension. ■ Test the extension. ■ Package the extension so that you can share it with others. For more information, see “Working with the Extension Manager” on page 109. Additional resources for extension writers To communicate with other developers who are involved in writing extensions, you might want to join the Dreamweaver extensibility newsgroup. You can access the website for this newsgroup at www.macromedia.com/go/extending_newsgrp/. What’s new in Dreamweaver Dreamweaver 8 includes the following new features and interfaces that are extensible. Each of these features has new related functions, which are listed in the Dreamweaver API Reference. ■ Improved site synchronization The comparison of local and remote files is more reliable in Dreamweaver 8. ■ Copy and paste improvements Copy and paste choices have been simplified. Users can also now set the default behavior of a paste operation to be to paste text only. ■ Site root-relative links mapping has been improved. ■ Code collapse Dreamweaver now lets users selectively collapse or expand segments of code. ■ Code view toolbar Dreamweaver now provides a toolbar in Code view that allows quick access to commonly used commands. ■ Background file transfer This feature lets users to do other things in Dreamweaver while processing server-related tasks. ■ File compare integration Dreamweaver now lets users launch a third-party file comparison application to compare two local files, two remote files, or the local and remote versions of a file