Title: EncycloShare Author: Knowledge Standards Foundation Published: October 25, 2023 Last modified: October 25, 2023 --- Search plugins This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://s.w.org/plugins/geopattern-icon/encycloshare.svg) # EncycloShare By [Knowledge Standards Foundation](https://profiles.wordpress.org/ksfound/) [Download](https://downloads.wordpress.org/plugin/encycloshare.zip) * [Details](https://pcd.wordpress.org/plugins/encycloshare/#description) * [Reviews](https://pcd.wordpress.org/plugins/encycloshare/#reviews) * [Installation](https://pcd.wordpress.org/plugins/encycloshare/#installation) * [Development](https://pcd.wordpress.org/plugins/encycloshare/#developers) [Support](https://wordpress.org/support/plugin/encycloshare/) ## Description Write encyclopedia articles for the world from your blog! Plugin makes adding your articles to encyclosphere aggregators as easy as pressing a button. ### Step One: Set up your blog’s digital identity. First, simply install [the Virtual Public Square plugin](https://wordpress.org/plugins/virtual-public-square/), as you would any WordPress plugin. Next, set up the did:psqr identity keys from the users list display. You have two options on how to generate your DID: EITHER (a) let the plugin create keys for you automatically (this is easy) OR (b) create them yourself offline and upload them to your blog (this is harder). Again, EITHER (a) **Use the plugin:** go to your Users list, and search for the account(s) you would like to create DIDs for. Admins will see buttons to allow generation, upload, or delete signature files for each user. Creating a DID for a user is simply a matter of pressing “Generate” and then filling out the form: OR (b) **Use the command line tool:** first, [follow the directions](https://public-square.github.io/cli/) to create a specialized did:psqr identity; then again navigate to the Users list and press “Upload” to upload the file. **Note:** the only difference between option (a) and (b) is that the code that creates your DID runs either on your blog server or by you, somewhere else. The same sorts of DID files will end up in the same place, on your blog.) ### Step Two: Configure the EncycloShare plugin. After installing the EncycloShare plugin (this one), you must configure your options at Settings > EncycloShare. There are inline instructions there. Pay close attention to **all** sections. They are all important (especially the password and the license!). **Important note:** at present, you will have to get in touch with an aggregator in order to obtain a password and to verify a publisher code. ### Important The 100% free (OSS) EncycloShare plugin adds the encyclopedic articles on your blog to the Encyclosphere. This means submitting your articles to various aggregators, so that your article(s) will (if accepted) appear on [EncycloSearch](https://encyclosearch.org/), [EncycloReader](https://encycloreader.org/), [DARA](https://encyclopedia.dara.global/#), the [Encyclosphere Chrome plugin](https://chrome.google.com/webstore/detail/encyclosphere/olhghbhocpjleboiiigeljhimfilkfnn), and soon others. This is a rapidly growing open, shared, and censorship-resistant database of publicly-available encyclopedia articles, and guarantees that your article will live on long after you are gone. Contribute to the global encyclopedia network, while retaining total control and licensing over your work, and bypassing Wikipedia. **Important:** this plugin will not work without setup. Follow the instructions in the **Installation** section. The plugin provides three pages/widgets: 1. a “Publish to Encyclosphere” button with per-article settings, located at **the bottom** of each blog post and page; 2. a Settings page, with global settings; and 3. a Dashboard panel, listing of all encyclopedia posts (ZWI files) that you submit. The plugin (and its required digital identity plugin) does the following for you, _after the required setup_: 1. allows you to submit articles to Encyclosphere aggregators( see above), including all your text, images, and probably other data as well, preserving your basic formatting; 2. for each submitted article, creates a ZWI file (“zipped wiki”: the standard encyclopedia article file format), deposited in a directory that you can make public if you like _**DOUBLECHECK THIS**_; 3. creates a digital identity associated with your blog (which you can use for many purposes), which follows the _entirely self-owned_ digital identity standard did:psqr (see below); 4. digitally signs your article, using your did:psqr digital identity; 5. allows you to configure basic data about your encyclopedia collection (such as license and language); and 6. allows you to tag your submitted ZWI files with categories, by tying in with the WordPress category system. NOTE: this **requires** the [Virtual Public Square (VPS) plugin](https://wordpress.org/plugins/virtual-public-square/).** Install the 100% free-and-OSS VPS plugin before attempting to use EncycloShare!** ### DISCLAIMERS **_You_ are the sole determiner of what license you publish under.** > While there is a default Creative Commons license selected, you _do not_ have > to use that license. There is a long list of licenses for you to choose a license > from. _If you do not want to permit any other websites to make use of your content, > then do not use this plugin!_ **Aggregation of your article is _not_ guaranteed.** > Using this plugin does not guarantee your article will appear in any aggregator. > Neither the plugin nor the Knowledge Standards Foundation (KSF) determines whether > your content will be accepted for inclusion in any particular aggregator. The > programmers that run the two KSF-affiliated aggregators, EncycloReader and EncycloSearch, > make these determinations independently of the KSF Board. Other aggregators in > the broader Encyclosphere network are entirely legally independent and separate, > and make their own decisions. **Depending on your license, your article might be published in places you did not know about or explicitly agree to.** > If you do not understand this, do not use this plugin. _Anyone_ might set up an > aggregator and, depending on your license, they might legally republish your content. > It is _your decision_ to permit them to do so. But open content projects like > Wikipedia and MIT OpenCourseWare have wisely decided to make their content very > widely available. The KSF commends this practice and hopes you decide to follow > it. **Article publishing is _not_ tracked (at present).** > The plugin does not display information about whether your publishing has been > accepted. You must click through yourself in order to make that determination. **Articles can _not_ be removed/unpublished with this plugin.** > There is no “unpublish” feature at present (we cannot say whether there ever will > be one). But two notes on this. (1) You can contact individual aggregators and > request that they remove your post. Whether they are legally obligated to do so > depends on the license you have chosen; most permissions granted by open content > licenses are permanent and irrevocable. (2) You can try replacing the text of > an article with a blank page and then submit that. It is possible (not guaranteed) > that the aggregator you have chosen will interpret this as an intention to remove > your article. ### In more detail **The standard file format** for encyclopedia articles, the [ZWI file format](https://docs.encyclosphere.org/#/zwi-format), has many requirements (specified by the [Knowledge Standards Foundation](https://encyclosphere.org/)). The EncycloShare plugin makes your posts fit these requirements. The plugin takes your encyclopedia post, uses it to prepare all necessary files (such as images) and directories following the ZWI standard, and finally compresses the result in a single ZWI file. A ZWI file is a a kind of ZIP file, so you can use any ZIP reader to view the contents, if you like. **The plugin then posts the ZWI file to an aggregator** or aggregators of your choosing, when you instruct it to do so. Depending on your license, the ZWI file might then( eventually) propagate to other aggregators. Each aggregator is responsible for maintaining its own database. Because Encyclosphere aggregators are developing a shared database standard as well, they can easily share articles, including yours. (We cannot guarantee that your work will be accepted by any given aggregator. Developers can set up their own aggregators, by installing the KSF’s free aggregator engine, [EncycloEngine](https://gitlab.com/ks_found/encycloengine).) **All ZWI files are stored** in a `/zwifiles` subdirectory of the standard WordPress`/ uploads` directory. So an article might be found, for example, at `https://YOURDOMAIN. COM/wp-content/uploads/zwifiles/YOUR-ARTICLE-12345.zwi`. **Publishing**, or submission to the Encyclosphere, happens when you press the “ Publish to Encyclosphere” button at the bottom of every WordPress post and page. You cannot, at this time, “unsubmit” an article, so make sure you really want to submit it. If you want to make edits and resubmit, you can. Probably a good way to _delete_ an article from the encyclosphere would be to simply make your page blank, and then submit the blank page. That is sure to be rejected, and the rejected ZWI will probably overwrite the old article, depending on circumstances. **The Dashboard Panel** shows any ZWI files that have been created. For now, you will have to follow the links provided in the panel to determine whether your submission has been accepted. You can also follow links to download, edit, and view articles in your collection. ### About Digital Signatures **Your ZWI files are digitally signed** and therefore can be authenticated as yours, wherever they eventually can be found on the internet. These digital signatures follow the [did:psqr](https://vpsqr.com/) “Virtual Public Square” digital identity standard. The KSF chose this standard because it allows you to declare and maintain your own identity on your own domain—so it is robustly self-owned. A digital signature is essential to maintaining your credit and claim to ownership in a wide-open network like the Encyclosphere. Aggregators will cryptographically validate your ZWI submissions( EncycloShare handles this for you automatically); such validation is required for acceptance by these network aggregators. All this is why you must install the (equally 100% free) Virtual Public Square plugin to utilize EncycloShare. **Your digital identity takes the form of a Decentalized Identifier (DID) file.** DID files contain identifying information you wish to share with the public and public keys used to verify your content. Your DID, when it is created, will be accessible at `https://YOURDOMAIN.COM/.well-known/psqr`. The Virtual Public Square plugin uses the W3C’s DID standard, and particularly the `did:psqr` specification, to attach proof of provenance to your content for distribution; further information on this specification is available at `https://vpsqr.com`. **Users are required to generate or upload their keys** before they can publish. The Virtual Public Square plugin automatically creates, uploads, and stores the relevant identity files according to the did:psqr digital identity standards. Instructions on how to do this (it is not hard) can be found under “Installation.” ### Usage Load a post or a page in edit mode. Some settings for the EncycloShare widget can be found below the text of your post. You can change a few values for each article you publish in ZWI format; these features and additions will expand. Any WordPress categories you add to a post or page will be added to the ZWI file format. Push the “Publish to Encyclosphere” button to publish your article to your selected aggregators. This button is visible for these user classes: editor, admin, author, and contributor. A toggle hidden response returns the results of your submission; these server responses are shown once and not saved. Go to https://encycloreader.org or https://encyclosearch.org/ to check whether your articles have been accepted. You can also find relevant links in the Dashboard Panel: A Dashboard Panel (the Admin Area home page found at `/wp-admin/index.php`) will list any ZWI files found in the uploads directory. ### Changelog/Terms ### 1.0 * Initial release ### Support * [Knowledge Standards Foundation](https://encyclosphere.org/) * [EncycloReader](https://encycloreader.org/) * [EncycloSearch](https://encyclosearch.org/) ### Terms of Use **See DISCLAIMERS under “Important” tab. Users understand that their work will be shared over an open network under a license or licenses that they solely determine.** Open Source Warranty. The Software includes certain Open Source Software. Open Source Software is governed solely by the applicable open source licensing terms, if any, and is provided “AS IS”. Other than as provided in the license, the Knowledge Standards Foundation makes no other warranties, express or implied, and hereby disclaims all implied warranties, including any warranty of merchantability and warranty of fitness for a particular purpose. Knowledge Standards Foundation provides no warranty specifically related to any Open Source Software or any applicable Open Source Software licensing terms. The foregoing language is not intended to limit Knowledge Standards Foundation’s warranty obligation for the Solution pursuant to Section 12.1. “Open Source Software” means software with its source code made available pursuant to a license by which, at a minimum, the copyright holder provides anyone the rights to study, change, and/or distribute the software to anyone and for any purpose. ## Installation You **must** complete two steps in order to use this plugin. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “EncycloShare” is open source software. The following people have contributed to this plugin. Contributors * [ Knowledge Standards Foundation ](https://profiles.wordpress.org/ksfound/) * [ encyclosphere ](https://profiles.wordpress.org/encyclosphere/) * [ psqr ](https://profiles.wordpress.org/psqr/) [Translate “EncycloShare” into your language.](https://translate.wordpress.org/projects/wp-plugins/encycloshare) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/encycloshare/), check out the [SVN repository](https://plugins.svn.wordpress.org/encycloshare/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/encycloshare/) by [RSS](https://plugins.trac.wordpress.org/log/encycloshare/?limit=100&mode=stop_on_copy&format=rss). ## Meta * Version **1.0** * Last updated **2 years ago** * Active installations **Fewer than 10** * WordPress version ** 5.4 or higher ** * Tested up to **6.2.9** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/encycloshare/) * Tags * [decentralization](https://pcd.wordpress.org/plugins/tags/decentralization/)[encyclopedia](https://pcd.wordpress.org/plugins/tags/encyclopedia/) [publishing](https://pcd.wordpress.org/plugins/tags/publishing/) * [Advanced View](https://pcd.wordpress.org/plugins/encycloshare/advanced/) ## Ratings No reviews have been submitted yet. [Add my review](https://wordpress.org/support/plugin/encycloshare/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/encycloshare/reviews/) ## Contributors * [ Knowledge Standards Foundation ](https://profiles.wordpress.org/ksfound/) * [ encyclosphere ](https://profiles.wordpress.org/encyclosphere/) * [ psqr ](https://profiles.wordpress.org/psqr/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/encycloshare/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://encyclosphere.org/)