%META:TOPICINFO{author="ProjectContributor" date="1655468868" format="1.1" version="1"}%
---+!! !FamFamFamContrib
%FORMFIELD{"Description"}%

%TOC%

---++ Usage

The icons are attached to the FamFamFamFlagIcons  FamFamFamMiniIcons  FamFamFamMintIcons  
FamFamFamSilkIcons FamFamFamSilkCompanion1Icons FamFamFamSilkGeoSilkIcons topics.

Some of these icons are used by the foswiki DocumentGraphics for the foswiki-wide =ICON= macro.

__This Contrib is part of the foswiki 1.1 release__

---+++ Topic action icons.
To replace the _Edit_, _Attach_ topic action buttons with icons, pre-pend your =SKIN= setting with =famfamfam=.

eg
<pre class="tml">
&nbsp;&nbsp;&nbsp;* Set SKIN=famfamfam,pattern
</pre>

---++ Examples (if installed)

   * <img src="%PUBURLPATH%/%SYSTEMWEB%/FamFamFamFlagIcons/au.png" alt="au.png" title="au.png" /> (=&lt;img src="%<nop>PUBURLPATH%/%SYSTEMWEB%/FamFamFamFlagIcons/au.png" /&gt;=)
   * <img src="%PUBURLPATH%/%SYSTEMWEB%/FamFamFamSilkIcons/bug_link.png" alt="bug_link.png" title="bug_link.png" /> (=&lt;img src="%<nop>PUBURLPATH%/%SYSTEMWEB%/FamFamFamSilkIcons/bug_link.png" /&gt;=)
   * <img src="%PUBURLPATH%/%SYSTEMWEB%/FamFamFamSilkIcons/arrow_up.png" alt="arrow_up.png" title="arrow_up.png" /> (=&lt;img src="%<nop>PUBURLPATH%/%SYSTEMWEB%/FamFamFamSilkIcons/arrow_up.png" /&gt;=)
   * <img src="%PUBURLPATH%/%SYSTEMWEB%/FamFamFamMiniIcons/arrow_up.gif" alt="arrow_up.gif" title="arrow_up.gif" /> (=&lt;img src="%<nop>PUBURLPATH%/%SYSTEMWEB%/FamFamFamMiniIcons/arrow_up.gif" /&gt;=)
   * <img src="%PUBURLPATH%/%SYSTEMWEB%/FamFamFamMintIcons/sound_grey.png" alt="sound_grey.ong" title="sound_grey.ong" /> (=&lt;img src="%<nop>PUBURLPATH%/%SYSTEMWEB%/FamFamFamMintIcons/sound_grey.png" /&gt;=)
   
---+++ Flags preview FamFamFamFlagIcons
<img src="%ATTACHURLPATH%/flags-preview.jpg" alt="flags-preview.jpg" />

---+++ Mini preview FamFamFamMiniIcons
<img src="%ATTACHURLPATH%/mini-preview.jpg" alt="mini-preview.jpg"  />

---+++ Mint preview FamFamFamMintIcons  
<img src="%ATTACHURLPATH%/mint-preview.jpg" alt="mint-preview.jpg"  />

---+++ Silk preview FamFamFamSilkIcons
<img src="%ATTACHURLPATH%/silk-preview.jpg" alt="silk-preview.jpg"  />

---+++ Silk preview FamFamFamSilkCompanion1Icons
<img src="%ATTACHURLPATH%/SilkCompanion1Thumb.png" alt="SilkCompanion1Thumb.png"  />

---+++ Silk preview FamFamFamSilkCompanion2Icons
<img src="%ATTACHURLPATH%/silk-companion-II.png" alt="silk-companion-II.png"  />

---+++ preview FamFamFamSilkGeoSilkIcons
<img src="%PUBURL%/%SYSTEMWEB%/FamFamFamSilkGeoSilkIcons/geosilk.png" />

---+++ Foswiki Extra Icons FamFamFamFoswikiExtras
%INCLUDE{%SYSTEMWEB%.FamFamFamFoswikiExtras}%

---++ Installation Instructions
You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -&gt; "Install, Update or Remove extensions" Tab.  Click the "Search for Extensions" button.  
Enter part of the extension name or description and press search.   Select the desired extension(s) and click install. If an extension is already installed, it will *not* show up in the
search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)
<verbatim>
cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install
</verbatim>

If you have any problems, or if the extension isn't available in =configure=, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.


---++ Info
Original Icons by Mark James http://www.famfamfam.com 

---++ Dependencies
None

---++ Change History
%TABLE{columnwidths="7em" tablewidth="100%"}%
|  03 Feb 2016 (1.9) | Fix typo in template =top:toolbarbutton_more=. |
|  08 Sep 2015 (1.8) | Foswikitask:Item13504: Correct minor typos and documentation issues. |
|  14 Jun 2015 (1.7) | Foswikitask:Item13393: SubscribePlugin changes to FamFamFam templates. |
|  18 Dec 2014 (1.6) | Foswikitask:Item12926: Convert to using html5 data attributes for validation tokens.<br />\
                       Foswikitask:Item12913: Fix some MANIFEST issues<br />\
                       Foswikitask:Item11411: Implement Foswiki:Development.HtmlAttributesShouldUseSingleQuotes |
|  13 Mar 2012 (1.5)   | added 119 GeoSilk icons |
|  06 Apr 2012 (1.4.4) | Released with Foswiki 1.1.5. Foswikitask:Item11383 - remove redundant %<nop>REVARG% from templates. |
|  12 Dec 2011 (1.4.3) | Released with Foswiki 1.1.4. Foswikitask:Item11104 - Added =trash-small= icon to !DocumentGraphics.  Foswikitask:Item11016 - Print should pass through URL parameters. Foswikitask:Item11341 - Add a Cog icon. |
|  03 May 2011 (1.4.1) | Foswikitask:Item10699 - Update METADATA for attachments |
|  11 Apr 2011 (1.4): | New homepage for "Universal Wiki Edit Button". <br />\
                        Remove !FamFamFam login/logout links and add foswikiAuthenticated class to allow conditional disabling of some buttons in some skins <br />\
                        Add ppsx to icon type list <br />\
                        Red star fixed so it is a star <br />\
                        Use more representative media icons <br />\
                        github icon added <br />\
                        To over-ride or add to the DocumentGraphics, you need to define a MybookSkinIconsTemplate - we had gotten it the wrong way around |
|  26 Jan 2011 (1.3): | Foswikitask:Item10275, Foswikitask:Item10283, Foswikitask:Item10285 - toolbar related fixes -- Foswiki:Main.IngoKappler  |
|  31 Jul 2010 (1.2): | Foswikitask:Item9415 - Documentation updates |
|  Apr 2010: | finish finding matching icons for all the legacy icon names - readying for 1.1 release |
|  Mar 2010: | include into foswiki 1.1 core and make it the default =ICONTOPIC= |
|  Jan 2010: | fix DocumentGraphics to be gif's because the foswiki 1.0 core is hardcoded to use gif |
|  Dec 2009: | add DocumentGraphics topic to allow replacement of ICONTOPIC, and add Silk Companion 2 icons by Chris Cagle | 
|  02 Aug 2009: | add a view template to allow us to use famfamfam icons for the top toolbar |
|  21 Jan 2009: | added Silk Companion 1 icons by Damien Guard |
|  26 Nov 2008: | compatibility Foswiki |

__Related Topics:__ [[%SYSTEMWEB%.Contribs][Contribs]], %SYSTEMWEB%.DeveloperDocumentationCategory, %SYSTEMWEB%.AdminDocumentationCategory, %SYSTEMWEB%.%WIKIPREFSTOPIC%, %LOCALSITEPREFS%

%META:FORM{name="PackageForm"}%
%META:FIELD{name="Author" title="Author" value="ProjectContributor"}%
%META:FIELD{name="Copyright" title="Copyright" value="&copy; Mark James http://www.famfamfam.com and Damien Guard http://damieng.com and Chris Cagle http://www.cagintranet.com/ and Sven Dowideit http://fosiki.com"}%
%META:FIELD{name="Description" title="Description" value="FamFamFam Silk is a smooth, free icon set, containing over 2000 icons"}%
%META:FIELD{name="Home" title="Home" value="http://foswiki.org/Extensions/FamFamFamContrib"}%
%META:FIELD{name="License" title="License" value="[[http://creativecommons.org/licenses/by/2.5/][Creative Commons Attribution 2.5 License]]"}%
%META:FIELD{name="Release" title="Release" value="18 Dec 2025"}%
%META:FIELD{name="Repository" title="Repository" value="https://github.com/foswiki/distro"}%
%META:FIELD{name="Support" title="Support" value="http://foswiki.org/Support/FamFamFamContrib"}%
%META:FIELD{name="Version" title="Version" value="1.9"}%
%META:FILEATTACHMENT{name="SilkCompanion1Thumb.png" attr="h" comment="" date="1655468868" size="169896" user="ProjectContributor" version="1"}%
%META:FILEATTACHMENT{name="silk-companion-II.png" attr="h" comment="" date="1655468868" size="24969" user="ProjectContributor" version="1"}%
%META:FILEATTACHMENT{name="mini-preview.jpg" attr="h" comment="" date="1655468868" size="13799" user="ProjectContributor" version="1"}%
%META:FILEATTACHMENT{name="mint-preview.jpg" attr="h" comment="" date="1655468868" size="3242" user="ProjectContributor" version="1"}%
%META:FILEATTACHMENT{name="flags-preview.jpg" attr="h" comment="" date="1655468868" size="14996" user="ProjectContributor" version="1"}%
%META:FILEATTACHMENT{name="silk-preview.jpg" attr="h" comment="" date="1655468868" size="22024" user="ProjectContributor" version="1"}%
