source: extensions/piwigopress/readme.txt @ 6769

Revision 4216, 4.5 KB checked in by vdigital, 10 years ago (diff)

[PiwigoPress]

  • Alternate pwg_get_contents (cURL)
  • Generated \r\n in code
  • Readme FAQ
  • Property svn:eol-style set to LF
  • Property svn:keywords set to Author Date Id Revision
Line 
1=== PiwigoPress ===
2Contributors: vpiwigo
3Donate link: http://www.vdigital.org/sharing/
4Tags: galleries, public pictures, randomize
5Requires at least: 2.8.4
6Tested up to: 2.8.5
7Stable tag: 1.0.4
8
9This widget integrates in your blog sidebars some randomized thumbnails and some links from your or any open API Piwigo gallery.
10
11== Description ==
12
13PiwigoPress is a WordPress 2.8 Sidebar Widget that links to the pictures of a Piwigo gallery.
14Thus, a Piwigo gallery with several public pictures in it is a prerequisite to make it work.
15But even if you don't have one yet, you can nonetheless give this plugin a try by using the
16Official Piwigo [demonstration gallery][] before
17setting up your own gallery.
18
19PiwigoPress can display several links to the Piwigo gallery in the sidebars of your WordPress
20blog, all of them being optional: a random thumbnail linking to the corresponding picture page,
21menus directing to all categories defined as public in the gallery, several additional links
22to most recent, most viewed, most commented pictures, and more.
23
24When you've finished testing and want to create you own gallery, go to the Piwigo [download page][],
25where you'll find all the links you might need.
26
27Try "NetInstall" first. If it fails, switch to the "Package" download and follow the full
28installation procedure. Try « pLoader » but in any case, you will find an « Instructions » link
29in your Piwigo gallery administration page.
30
31A Widget signed and supported by the Piwigo Team.
32[demonstration gallery]: http://piwigo.org/demo  "The demonstration gallery"
33[download page]: http://piwigo.org/downloads  "Piwigo download page"
34
35== Installation ==
36
37How to install PiwigoPress and get it working.
38
391. Upload `PiwigoPress` complete folder to the `/wp-content/plugins/` directory
402. Activate the plugin through the 'Plugins' menu in WordPress
413. Access to Widgets, draw PiwigoPress to the sidebar you want
42
43Explanation of Plugin data fields.
44
45Title: To use in the sidebar
46Get thumbnails: Embed thumbnails or ignore (Another option will come later)
47Local directory (if local): Piwigo installation directory (on the same website)
48(or) External gallery URL: URL to the gallery (if not local)
49Number of pictures (0=none): Number of thumbnails to get
50
51Optional parameters
52Category id (0=all): Pictures from a specific Piwigo category or from all
53Since X months (0=all): Age of posted picture
54CSS DIV class: For your blog design
55CSS IMG class: For your blog design
56Categories menu: Includes all links related to Piwigo categories
57
58All below selectable option are special Piwigo links to include:
59* Most visited
60* Best rated
61* Most commented (need a plugin in the client gallery)
62* Random
63* Recent pics
64* Calendar
65* Keywords
66* Comments
67
68== Frequently Asked Questions ==
69
70No thumbnail are displayed.
71Since (12) months and no public pictures since July 2005): Try 99 or 0 months!
72Class CSS includes a display: none; Check your css!
73Private Category instead of public; Check the selected category!
74
75Category (0) since (0) months and correct CSS class, then check:
76- Locked Gallery
77- Mandatory subscription
78- All private categories
79- All locked categories
80- Picture privacy level (> 0 : must be 0 ---)
81
82
83
84Example of Class:
85.img-shadow {
86  float:left;
87  background: url(images/shadowAlpha.png) no-repeat bottom right !important;
88  background: url(images/shadow.gif) no-repeat bottom right;
89  margin: 10px 0 0 10px !important;
90  margin: 10px 0 0 5px;
91  }
92 
93.img-shadow img {
94  display: block;
95  position: relative;
96  background-color: #fff;
97  border: 1px solid #a9a9a9;
98  margin: -6px 6px 6px -6px;
99  padding: 4px;
100  }
101       
102        Will be included in future releases:
103        http://www.vdigital.org/sharing/wp-content/themes/green-apples/images/shadowAlpha.png
104        http://www.vdigital.org/sharing/wp-content/themes/green-apples/images/shadow.gif
105
106= A question that someone might have =
107
108Anwsers will come later.
109
110== Screenshots ==
111
1121. Widget parameters for the demo gallery
1132. Expected result in your sidebar
1143. Widget parameters for your gallery (on the same domain)
115
116== Changelog ==
117
118= 1.05 =
119* Alternate pwg_get_contents (cURL)
120
121= 1.04 =
122* Alternate pwg_get_contents (file\_get\_contents, fsockopen, ...)
123* cURL is coming
124
125= 1.03 =
126* Project rename: Directory name changed for WordPress constraints
127* Language issue solved
128* Pre-version for WordPress publication
129
130= 1.02 =
131* Project rename: Public Piwigo WordPress Widget becomes PiwigoPress
132* I18n version (Italian)
133
134= 1.01 =
135* I18n version (French, Spanish,...)
136* Link bug with some theme... Solved.
137
138= 1.0 =
139* First version.
Note: See TracBrowser for help on using the repository browser.