{"id":20049016,"url":"https://github.com/unlock-protocol/unlock-wordpress-plugin","last_synced_at":"2025-10-18T20:24:34.700Z","repository":{"id":38050341,"uuid":"207642460","full_name":"unlock-protocol/unlock-wordpress-plugin","owner":"unlock-protocol","description":"A plugin for Wordpress to add locked sections to both your posts and pages!","archived":false,"fork":false,"pushed_at":"2023-08-01T15:26:25.000Z","size":2018,"stargazers_count":16,"open_issues_count":18,"forks_count":16,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-08T21:41:25.144Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://wordpress.org/plugins/unlock-protocol/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unlock-protocol.png","metadata":{"files":{"readme":"README.txt","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-09-10T19:10:11.000Z","updated_at":"2023-05-26T15:29:17.000Z","dependencies_parsed_at":"2023-01-27T23:01:04.896Z","dependency_job_id":null,"html_url":"https://github.com/unlock-protocol/unlock-wordpress-plugin","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlock-protocol%2Funlock-wordpress-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlock-protocol%2Funlock-wordpress-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlock-protocol%2Funlock-wordpress-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlock-protocol%2Funlock-wordpress-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unlock-protocol","download_url":"https://codeload.github.com/unlock-protocol/unlock-wordpress-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252480533,"owners_count":21754787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T11:47:59.575Z","updated_at":"2025-10-18T20:24:34.610Z","avatar_url":"https://github.com/unlock-protocol.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"=== Unlock Protocol ===\nContributors: julien51\nTags: paywall, ethereum, monetization, unlock, membership, subscription, member\nRequires at least: 5.1\nTested up to: 5.9\nRequires PHP: 7.0\nStable tag: 4.0.1\nLicense: GPLv3\nLicense URI: https://github.com/unlock-protocol/unlock-wordpress-plugin/blob/master/LICENSE\n\nThis plugin lets authors add locks to their posts and pages so that only paying visitors can view their content.\n\n== Description ==\n\n[Unlock](https://unlock-protocol.com/) is a protocol for memberships that lets any creator monetize their content permissionless.\n\nIn order to become members, visitors may need to be using a web3-enabled wallet such as [MetaMask](https://metamask.io/) or a web browser with an embedded wallet, such as [Opera](https://www.opera.com/crypto). They also need a balance of crypto-currency to purchase the memberships.\n\nThe plugin enables \"full-post\" locking, or just block-level level locking, using the Gutemberg Editor.\n\nThe plugin uses Unlock's default checkout UI, which means it lets users who do not have wallet create an Unlock account or even pay using credit card, if your lock supports this.\n\n== Getting Started ==\n\nIf you'd like to add a lock to your site, start by [deploying your first lock]https://app.unlock-protocol.com/locks/create). We _strongly_ recommend starting with a test network such as Goerli.\n\nWhile the lock is deploying, you should [download this plugin](https://wordpress.org/plugins/unlock-protocol/) from the WordPress site. Then, from the administration of your WordPress.org website, in the `Plugins` section, click on the `Add New button and then on the `Upload Plugin` button to upload the plugin.\n\nNote: To allow new users to log in using their Ethereum wallet with a single click, make sure that __Settings \u003e General \u003e Anyone can register__ (for single sites) or __Network Settings \u003e Allow new registrations \u003e User accounts__ may be registered (for multisites) is enabled. Your existing users can link their wallets to their WordPress accounts regardless of this setting.\n\n== Writing locked stories ==\n\nYou can either choose to lock the whole post, using the post-level settings, or to lock specific Blocks in the UI with the Gutenberg Editor, for posts and pages.\n\nTo add the Unlock Protocol block inside the page/post please follow the below steps:\n\n1. Click on Post -\u003e Add New\n2. To add a block you just need to click on “+” in the editor.\n3. Enter Unlock Protocol in the search.\n4. Unlock Protocol block will be shown. Click on the block, the block gets added.\n5. You will be able to see block settings on the right side. From block settings, add at least one lock, select the right network and, enter its address.\n\nOnce your page or post includes the content you need, you can preview its content like any other WordPress post or page. We recommend the use of a web3 wallet which supports multiple accounts so that you can easily toggle between accounts which are already members and accounts which are not members yet!\n\n== Contributing ==\n\nThis plugin is, like all of the Unlock code, [open source](https://github.com/unlock-protocol/unlock-wordpress-plugin). You're encouraged to fork it and make any changes you'd like! If you believe these changes would be beneficial to others, we encourage you to also open a Pull Request so that we could add these to the main branch released on the wordpress.org website!\n\n= Local Development =\n\nTo setup local development environment for the plugin using we recommend using [Localwp](https://localwp.com/). To get started, simply clone the repo from [GitHub](https://github.com/unlock-protocol/unlock-wordpress-plugin).\n\n\nThe repo includes a `unlock-wordpress-plugin` which has the required `.php` files and in which asset files (javascript, CSS and images) are added at build time.\n\nYou can package the whole plugin by using `yarn run release` and install it in your local WordPress instance. Alternatively, you can add a symbolic link in the local WordPress's `wp-content/plugins` folder that points to the `unlock-wordpress-plugin`.\n\n= Publishing the plugin =\n\nIn order to update the plugin, check out the current subversion state with\n\n    svn co  https://plugins.svn.wordpress.org/unlock-protocol\n\nThen, from the GitHub repo clone, inside the `assets` folder, write\n\n    yarn run release\n\nThis will generate a zip file in dist directory, unzip that file and copy the content to trunk directory in svn repo and commit the changes into svn with\n\n    svn ci -m \"commit message\"\n\nThen, tag the new version (replace X and Y!) to release it:\n\n    svn cp trunk tags/X.Y\n    svn ci -m \"tagging version X.Y\"\n\nAdditionally, please make sure you tag the version on Github:\n\n    git tag -a X.Y -m \"tagging version X.Y\"\n    git push origin X.Y\n\nAnd finally, create the release on Github'si UI\n\n\n== Frequently Asked Questions ==\n\nTo be completed with questions!\n\n== Changelog ==\n\n= 4.0.1 =\n\n* Version bump to reflect changes in README\n\n= 4.0.0 =\n\n* Re-architected plugin\n* Adding support for fully locked posts\n\n= 3.2.3 =\n\n* Updated RPC endpoints\n\n= 3.2.2 =\n\n* Fixing auth endpoint\n\n= 3.2.1 =\n\n* Changed default RPC endpoint for gnosis chain\n* Support for PHP7.0\n* Checkout URL customization\n* Endpoint customization\n\n= 3.2.0 =\n\n* Switching RPC check to use getHasValidKey so that it can grant access based on the hasValidKeyHook\n\n= 3.1.0 =\n* Adding support for blocks with multiple locks\n\n= 3.0.0 =\n* Brand new plugin with updated UI\n* User can login to the WordPress site by using Unlock Protocol account.\n* Pre-filled networks\n* Setting to add/delete networks.\n* Setting to customize the login and checkout button.\n* User is linked with the Unlock Protocol site.\n* Now the login and purchase is validated from the Unlock Protocol site and content is displaying after the user has the correct access on that specific content.\n* Added new Hooks.\n\n= 2.1 =\n* Uses the latest Unlock paywall script https://unlock-protocol.com/blog/introducing-latest-paywall/\n\n= 2.0 =\n* each post/page can have a different configuration\n* block setting is now visible inside of the Editor\n\n= 1.6 =\n* Button is not only visible when content is locked\n\n= 1.5 =\n* Cleanup\n\n= 1.1 =\n* Supporting nested blocks.\n\n= 1.0 =\n* Initial version\n\n== Upgrade Notice ==\n\nThis new version is not compatible with the old version of the plugin, please backup your content before upgrade.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funlock-protocol%2Funlock-wordpress-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funlock-protocol%2Funlock-wordpress-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funlock-protocol%2Funlock-wordpress-plugin/lists"}