{"id":1742,"date":"2024-08-27T09:36:15","date_gmt":"2024-08-27T09:36:15","guid":{"rendered":"https:\/\/piwigo.com\/blog\/?p=1742"},"modified":"2024-11-19T09:14:05","modified_gmt":"2024-11-19T09:14:05","slug":"the-new-piwigo-documentation-is-now-available","status":"publish","type":"post","link":"https:\/\/piwigo.com\/blog\/2024\/08\/27\/the-new-piwigo-documentation-is-now-available\/","title":{"rendered":"The new Piwigo documentation is now available!"},"content":{"rendered":"\n

After months of work, the new Piwigo documentation is now available! We’ve tried to make it as complete and clear as possible, but this is just the beginning. In this article, we’ll explain how to access the doc, how to use it and how to give us your feedback.<\/strong><\/p>\n\n\n\n\n\n\n\n

Where can I find Piwigo documentation?<\/h2>\n\n\n\n

First of all, you can access it at this address: https:\/\/doc.piwigo.org\/<\/a><\/p>\n\n\n\n

Bookmark it!<\/p>\n\n\n\n

You can also find it at any time from the web site https:\/\/piwigo.org<\/a>, or from your Piwigo administration, by clicking on the \u201cHelp\u201d section and clicking on the link in the blue banner. (This is already available for piwigo.com customers. For self hosted users, this we be included in the next release).<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Why this new documentation?<\/h2>\n\n\n\n

This project was born in the team’s mind a long time ago.<\/p>\n\n\n\n

When we carried out our big survey in 2020<\/a>, the need for more comprehensive and complete documentation often came up in user feedback: it was the 2nd wish of respondents to the \u201cHow to improve Piwigo\u201d question!<\/p>\n\n\n\n

Indeed, Piwigo’s historical documentation, accessible from the <\/a>https:\/\/piwigo.org<\/a> website, had not been updated for a long time, and did not cover all of Piwigo’s capabilities. Moreover, it was perceived as too \u201ctechnical\u201d.<\/p>\n\n\n\n

We first published a first version of this brand new documentation in French in August 2023. We improved and enriched it, and finally Ana\u00ebl took on the task of translating it into English during the summer of 2024.<\/p>\n\n\n\n

How can you send us your opinions and comments on this documentation?<\/h2>\n\n\n\n

To improve this doc, we need your help!<\/p>\n\n\n\n

If you have any suggestions for improvement, if you’ve spotted an error, if you’re missing information, if you simply want to send us your opinion (whether positive or negative), you can send us your feedback via this form<\/a>. All feedback will be read!<\/p>\n\n\n\n

You can also discuss it with the community on the Piwigo forum, via the dedicated post<\/a>.<\/p>\n\n\n\n

Who is this documentation for?<\/h2>\n\n\n\n

Piwigo.com customers or self-hosted?<\/h3>\n\n\n\n

This documentation is intended for all Piwigo users, whether you are a piwigo.com customer or a self-hosted Piwigo user.<\/p>\n\n\n\n

Some features differ depending on whether you are in one situation or the other: we specify this each time.<\/p>\n\n\n\n

For example, users of a self-hosted Piwigo can upload photos to Piwigo through FTP, whereas customers of a piwigo.com subscription cannot.<\/p>\n\n\n\n

Another example: piwigo.com customers don’t have access to all available plugins, depending on the package they subscribe to. Every time we mention a \u201cPremium\u201d plugin in the documentation, we specify for which Piwigo.com offer it is available. Of course, this does not apply to customers who are still benefiting from an older offer.<\/p>\n\n\n\n

But overall, 90% of the articles in this documentation are aimed at all types of users.<\/p>\n\n\n\n

The \u201cPiwigo self-hosting<\/a>\u201d section is intended only for users of self-hosted Piwigo. It will be enriched over time.<\/p>\n\n\n\n

Administrators or \u201cclassic\u201d users?<\/h3>\n\n\n\n

Most of the articles in this documentation are aimed at administrators and webmasters, who have access to Piwigo’s administration.<\/p>\n\n\n\n

Some of the sections describing how to use the gallery may be useful for \u201csimple\u201d users (who do not have access to the administration). This is particularly true of the section in the documentation entitled Browsing your gallery<\/a>.<\/p>\n\n\n\n

However, remember that every Piwigo gallery is different, depending on the theme it uses, its graphic customization, and the configuration of the theme and Piwigo. <\/p>\n\n\n\n

The documentation presents the \u201cbasic\u201d Piwigo configuration, using the Modus theme in its default version. As a result, the screenshots shown may differ significantly from the appearance of your gallery, even if the functionalities remain the same.<\/p>\n\n\n\n

What about developers?<\/h3>\n\n\n\n

This documentation is not intended to be technical: it focuses on Piwigo’s features. Piwigo’s technical documentation, aimed at developers, is available on our GitHub space<\/a>.<\/p>\n\n\n\n

What will you find in this documentation?<\/h2>\n\n\n\n

We have tried to structure the documentation as logically as possible, so that you can find answers to all your questions:<\/p>\n\n\n\n