1*b1cdbd2cSJim Jagielski<?xml version="1.0" encoding="UTF-8"?><helpdocument version="1.0"> 2*b1cdbd2cSJim Jagielski<!--*********************************************************** 3*b1cdbd2cSJim Jagielski * 4*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 5*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 6*b1cdbd2cSJim Jagielski * distributed with this work for additional information 7*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 8*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 9*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 10*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 11*b1cdbd2cSJim Jagielski * 12*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 13*b1cdbd2cSJim Jagielski * 14*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 15*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 16*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 17*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 18*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 19*b1cdbd2cSJim Jagielski * under the License. 20*b1cdbd2cSJim Jagielski * 21*b1cdbd2cSJim Jagielski ***********************************************************--> 22*b1cdbd2cSJim Jagielski 23*b1cdbd2cSJim Jagielski 24*b1cdbd2cSJim Jagielski 25*b1cdbd2cSJim Jagielski<meta> 26*b1cdbd2cSJim Jagielski<topic id="textshared01packagemanagerxml" indexer="include"> 27*b1cdbd2cSJim Jagielski<title xml-lang="en-US" id="tit">Extension Manager</title> 28*b1cdbd2cSJim Jagielski<filename>/text/shared/01/packagemanager.xhp</filename> 29*b1cdbd2cSJim Jagielski</topic> 30*b1cdbd2cSJim Jagielski</meta> 31*b1cdbd2cSJim Jagielski<body> 32*b1cdbd2cSJim Jagielski<section id="packagemanager"> 33*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="index" id="bm_id2883388"> 34*b1cdbd2cSJim Jagielski<bookmark_value>UNO components;Extension Manager</bookmark_value> 35*b1cdbd2cSJim Jagielski<bookmark_value>extensions;Extension Manager</bookmark_value> 36*b1cdbd2cSJim Jagielski<bookmark_value>packages, see extensions</bookmark_value> 37*b1cdbd2cSJim Jagielski</bookmark><comment>MW corrected typos in "UNO components;...", made "Extension Manager" a two level entry and changed the "packages" reference</comment> 38*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_PACKAGE_MANAGER_MENU_ITEM" id="bm_id307931" localize="false"/> 39*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/service:com.sun.star.deployment.ui.PackageManagerDialog" id="bm_id2198553" localize="false"/> 40*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_PACKAGE_MANAGER" id="bm_id828882" localize="false"/> 41*b1cdbd2cSJim Jagielski<paragraph id="par_idN10543" role="heading" xml-lang="en-US" level="1"><link href="text/shared/01/packagemanager.xhp">Extension Manager</link></paragraph><comment>renamed in i69568</comment> 42*b1cdbd2cSJim Jagielski<paragraph id="par_idN10553" role="paragraph" xml-lang="en-US"><ahelp hid="42772">The Extension Manager adds, removes, disables, enables, and updates %PRODUCTNAME extensions.</ahelp></paragraph> 43*b1cdbd2cSJim Jagielski</section> 44*b1cdbd2cSJim Jagielski<section id="howtoget"><embed href="text/shared/00/00000406.xhp#packagemanager"/> 45*b1cdbd2cSJim Jagielski</section> 46*b1cdbd2cSJim Jagielski<paragraph id="par_idN10615" role="paragraph" xml-lang="en-US">The following are examples of %PRODUCTNAME extensions:</paragraph> 47*b1cdbd2cSJim Jagielski<list type="ordered"> 48*b1cdbd2cSJim Jagielski<listitem> 49*b1cdbd2cSJim Jagielski<paragraph id="par_idN1061B" role="paragraph" xml-lang="en-US">UNO components (compiled software modules)</paragraph> 50*b1cdbd2cSJim Jagielski</listitem> 51*b1cdbd2cSJim Jagielski<listitem> 52*b1cdbd2cSJim Jagielski<paragraph id="par_idN1061F" role="paragraph" xml-lang="en-US">Configuration data (for menu commands)</paragraph> 53*b1cdbd2cSJim Jagielski</listitem> 54*b1cdbd2cSJim Jagielski<listitem> 55*b1cdbd2cSJim Jagielski<paragraph id="par_idN10623" role="paragraph" xml-lang="en-US">%PRODUCTNAME Basic libraries</paragraph> 56*b1cdbd2cSJim Jagielski</listitem> 57*b1cdbd2cSJim Jagielski<listitem> 58*b1cdbd2cSJim Jagielski<paragraph id="par_idN106E8" role="paragraph" xml-lang="en-US">%PRODUCTNAME dialog libraries</paragraph> 59*b1cdbd2cSJim Jagielski</listitem> 60*b1cdbd2cSJim Jagielski<listitem> 61*b1cdbd2cSJim Jagielski<paragraph id="par_idN106F5" role="paragraph" xml-lang="en-US">Extension files (*.oxt files containing one or more extensions of the above listed types)</paragraph> 62*b1cdbd2cSJim Jagielski</listitem> 63*b1cdbd2cSJim Jagielski</list> 64*b1cdbd2cSJim Jagielski<paragraph id="hd_id8570513" role="heading" xml-lang="en-US" level="2">Extension Scope</paragraph> 65*b1cdbd2cSJim Jagielski<paragraph id="par_idN1068A" role="paragraph" xml-lang="en-US">Users with administrator or root privileges will see a dialog where they can choose to install extensions "for all users" or "only for me". Normal users without those privileges can install, remove, or modify extensions only for their own use.</paragraph> 66*b1cdbd2cSJim Jagielski<list type="ordered"> 67*b1cdbd2cSJim Jagielski<listitem> 68*b1cdbd2cSJim Jagielski<paragraph id="par_idN10626" role="paragraph" xml-lang="en-US">A user with root or administrator privileges can install an extension as a shared extension that is available to all users. After selecting an extension, a dialog opens and asks whether to install for the current user or all users.</paragraph> 69*b1cdbd2cSJim Jagielski</listitem> 70*b1cdbd2cSJim Jagielski<listitem> 71*b1cdbd2cSJim Jagielski<paragraph id="par_idN1069C" role="paragraph" xml-lang="en-US">A user without root privileges can only install an extension for own usage. This is called a user extension.</paragraph> 72*b1cdbd2cSJim Jagielski</listitem> 73*b1cdbd2cSJim Jagielski</list><comment>UFI: Extension Guide needed. Until we have that guide, I'll add some more info in this file.</comment> 74*b1cdbd2cSJim Jagielski<paragraph id="hd_id3895382" role="heading" xml-lang="en-US" level="2">To install an extension</paragraph> 75*b1cdbd2cSJim Jagielski<paragraph id="par_id9143955" role="paragraph" xml-lang="en-US">An extension is available as a file with the file extension .oxt.</paragraph> 76*b1cdbd2cSJim Jagielski<paragraph id="par_id7857905" role="paragraph" xml-lang="en-US">You can find a collection of extensions on the Web. Click the "Get more extensions here" link in the Extension Manager to open your Web browser and see the <link href="http://extensions.openoffice.org/">http://extensions.openoffice.org/</link> page.<comment># i78606</comment></paragraph> 77*b1cdbd2cSJim Jagielski<paragraph id="hd_id5016937" role="heading" xml-lang="en-US" level="3">To install a user extension</paragraph> 78*b1cdbd2cSJim Jagielski<paragraph id="par_id1856440" role="paragraph" xml-lang="en-US">Do any of the following:</paragraph> 79*b1cdbd2cSJim Jagielski<list type="ordered"> 80*b1cdbd2cSJim Jagielski<listitem> 81*b1cdbd2cSJim Jagielski<paragraph id="par_id7654347" role="paragraph" xml-lang="en-US">Double-click the <item type="literal">.oxt</item> file in your system's file browser.</paragraph> 82*b1cdbd2cSJim Jagielski</listitem> 83*b1cdbd2cSJim Jagielski<listitem> 84*b1cdbd2cSJim Jagielski<paragraph id="par_id5269020" role="paragraph" xml-lang="en-US">On a web page, click a hyperlink to an <item type="literal">*.oxt</item> file (if your web browser can be configured to start the Extension Manager for this file type).</paragraph> 85*b1cdbd2cSJim Jagielski</listitem> 86*b1cdbd2cSJim Jagielski<listitem> 87*b1cdbd2cSJim Jagielski<paragraph id="par_id8714255" role="paragraph" xml-lang="en-US">Choose <item type="menuitem">Tools - Extension Manager</item> and click <item type="menuitem">Add</item>.</paragraph> 88*b1cdbd2cSJim Jagielski</listitem> 89*b1cdbd2cSJim Jagielski</list> 90*b1cdbd2cSJim Jagielski<paragraph id="hd_id3734550" role="heading" xml-lang="en-US" level="4">To install a shared extension in text mode (for system administrators)</paragraph> 91*b1cdbd2cSJim Jagielski<list type="ordered"> 92*b1cdbd2cSJim Jagielski<listitem> 93*b1cdbd2cSJim Jagielski<paragraph id="par_id4139225" role="paragraph" xml-lang="en-US">As an administrator, open a terminal or command shell.</paragraph> 94*b1cdbd2cSJim Jagielski</listitem> 95*b1cdbd2cSJim Jagielski<listitem> 96*b1cdbd2cSJim Jagielski<paragraph id="par_id671712" role="paragraph" xml-lang="en-US">Change to the <switchinline select="sys"><caseinline select="WIN">\ 97*b1cdbd2cSJim Jagielski</caseinline><defaultinline>/</defaultinline></switchinline>program folder in your installation.</paragraph> 98*b1cdbd2cSJim Jagielski</listitem> 99*b1cdbd2cSJim Jagielski<listitem> 100*b1cdbd2cSJim Jagielski<paragraph id="par_id4163945" role="paragraph" xml-lang="en-US">Enter the following command, using the path and file name of your extension:</paragraph> 101*b1cdbd2cSJim Jagielski<paragraph id="par_id9581591" role="paragraph" xml-lang="en-US"><item type="literal">unopkg add --shared path_filename.oxt</item></paragraph> 102*b1cdbd2cSJim Jagielski</listitem> 103*b1cdbd2cSJim Jagielski</list> 104*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_PACKAGE_MANAGER_TREELISTBOX" id="bm_id8800927" localize="false"/> 105*b1cdbd2cSJim Jagielski<paragraph id="par_idN106AD" role="paragraph" xml-lang="en-US"><ahelp hid="42769">Select the extension that you want to remove, enable, or disable. For some extensions, you can also open an Options dialog.</ahelp></paragraph> 106*b1cdbd2cSJim Jagielski<paragraph id="par_idN10639" role="heading" xml-lang="en-US" level="2">Add</paragraph> 107*b1cdbd2cSJim Jagielski<paragraph id="par_idN106BA" role="paragraph" xml-lang="en-US"><ahelp hid="2180256276">Click Add to add an extension.</ahelp></paragraph> 108*b1cdbd2cSJim Jagielski<paragraph id="par_idN106BD" role="paragraph" xml-lang="en-US">A file dialog opens where you can select the extension that you want to add. To copy and to register the selected extension, click Open.</paragraph> 109*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/desktop:MultiLineEdit:RID_DLG_LICENSE:ML_LICENSE" id="bm_id2089297" localize="false"/> 110*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/desktop:PushButton:RID_DLG_LICENSE:PB_LICENSE_DOWN" id="bm_id3366801" localize="false"/> 111*b1cdbd2cSJim Jagielski<paragraph id="par_id4856410" role="paragraph" xml-lang="en-US">An extension can show a license dialog. <ahelp hid=".">Read the license. Click the Scroll Down button to scroll down if necessary. Click Accept to continue the installation of the extension.</ahelp></paragraph><comment>insert hidden text for Show License</comment> 112*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_EXTENSION_MANAGER_LISTBOX_REMOVE" id="bm_id0523200810562584" localize="false"/> 113*b1cdbd2cSJim Jagielski<paragraph id="par_idN10643" role="heading" xml-lang="en-US" level="2">Remove</paragraph> 114*b1cdbd2cSJim Jagielski<paragraph id="par_idN106D1" role="paragraph" xml-lang="en-US"><ahelp hid="2180256277">Select the extension that you want to remove, and then click Remove.</ahelp></paragraph> 115*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_EXTENSION_MANAGER_LISTBOX_DISABLE" id="bm_id0523200810570553" localize="false"/> 116*b1cdbd2cSJim Jagielski<paragraph id="par_id0523200810573866" role="paragraph" xml-lang="en-US"><ahelp hid="." visibility="hidden">Enable or disable the extension.</ahelp></paragraph> 117*b1cdbd2cSJim Jagielski<paragraph id="par_idN1064D" role="heading" xml-lang="en-US" level="2">Enable</paragraph> 118*b1cdbd2cSJim Jagielski<paragraph id="par_idN106DE" role="paragraph" xml-lang="en-US"><ahelp hid="2180256278">Select the extension that you want to enable, and then click Enable.</ahelp></paragraph> 119*b1cdbd2cSJim Jagielski<paragraph id="par_idN10657" role="heading" xml-lang="en-US" level="2">Disable</paragraph> 120*b1cdbd2cSJim Jagielski<paragraph id="par_idN106EB" role="paragraph" xml-lang="en-US"><ahelp hid="2180256279">Select the extension that you want to disable, and then click Disable.</ahelp></paragraph> 121*b1cdbd2cSJim Jagielski<paragraph id="hd_id4453566" role="heading" xml-lang="en-US" level="2">Update</paragraph> 122*b1cdbd2cSJim Jagielski<paragraph id="par_id4129459" role="paragraph" xml-lang="en-US"><ahelp hid=".">Click to check for online updates of all installed extensions. To check for updates of the selected extension only, choose the Update command from the context menu. The check for availability of updates starts immediately.</ahelp> You will see the <link href="text/shared/01/extensionupdate.xhp">Extension Update</link> dialog.</paragraph> 123*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_EXTENSION_MANAGER_LISTBOX_OPTIONS" id="bm_id052320081054360" localize="false"/> 124*b1cdbd2cSJim Jagielski<paragraph id="hd_id4921414" role="heading" xml-lang="en-US" level="2">Options</paragraph> 125*b1cdbd2cSJim Jagielski<paragraph id="par_id1439558" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select an installed extension, then click to open the Options dialog for the extension.</ahelp></paragraph> 126*b1cdbd2cSJim Jagielski<paragraph id="par_id0103201110331832" role="paragraph" xml-lang="en-US">Some additional commands can appear in the context menu of an extension in the Extension Manager window, depending on the selected extension. You can choose to show the license text again. You can choose to exclude the extension from checking for updates or to include an excluded extension.</paragraph> 127*b1cdbd2cSJim Jagielski</body> 128*b1cdbd2cSJim Jagielski</helpdocument> 129