palfrey

<p>Panegyric is a WordPress plugin for displaying Github Pull Requests created by a list of organisations and/or users.<br />
It’s main usage is for an organisation or user to show off all the cool stuff they’ve done for open source projects.</p>
<p>To use it, add the <code>github_prs</code> shortcode to a page. Simplest form is <code>[github_prs orgs="lshift"]</code> (replace <code>lshift</code> with your Github organisation name).</p>
<p>Additional parameters are supported as follows:</p>
<ul>
<li><code>orgs</code>: Comma-separated list of organisations. Optional, but if you omit this and <code>users</code>, it won’t do anything. Default is <code>""</code></li>
<li><code>users</code>: Comma-separated list of users. Optional, but as per <code>orgs</code>, it’s kinda recommended. Default is <code>""</code>.</li>
<li><code>limit</code>: Number of Pull Requests to show. Default is 10.</li>
<li><code>format</code>: Format of items. Default is <code>{$updated_at}: "<a href="{$pr_url}">{$pr_title}</a>" was done by <a href="{$user_url}">{$name}</a> for <a href="{$repo_url}">{$repo_name}</a></code>. The various <code>${variables}</code> in the default format are all the ones supported currently.</li>
</ul>
<p>For <code>format</code>, if you want to include <code>"</code> characters, you should write it with single quotes on the outside, and not do escaping. This is actually <a href="https://core.trac.wordpress.org/ticket/15434" rel="nofollow ugc">a WordPress problem</a>, but it doesn’t unfortunately do a nice error message, it just fails!</p>
<p>The list of pull requests is determined as follows:</p>
<ol>
<li>For every organisation, get all their public users.</li>
<li>Add that to the list of users.</li>
<li>For each user, get all their merged pull requests.</li>
<li>List in reverse date order every Pull Request that’s not in the user list or the <code>orgs</code> list. Stop when you hit the <code>limit</code>.</li>
</ol>
<p>The data for these requests are updated once per day (or when someone clicks the relevant date field on the admin page), via the magic of WP Cron (the standard WordPress update mechanism). You will need to manually update people when you first add them, but the plugin will bug you about that.</p>
<p>Lists have the CSS class <code>panegyric-list</code> and the items have the class <code>panegyric-item</code>.</p>


Panegyric

Why else contribute to open-source if you can't show it off haha 

Cool plugin with lots of potential

Panegyric is a Wordpress plugin for displaying Github Pull Requests created by a list of organisations and/or users.

pReya

<p>This is a plugin for WordPress to embed Markdown files from external web sources (e.g. GitHub, GitLab, etc) into WordPress content using the shortcode <code>[external_markdown]</code>. A possible use case for this is to show content from a single source of truth (like a GitHub repository) on your WordPress website.</p>
<h3>Features</h3>
<ul>
<li>Embed any publicly accessible markdown file from other websites</li>
<li>Uses the public and free <a href="https://docs.github.com/en/rest/reference/markdown" rel="nofollow ugc">GitHub API</a> to transform Markdown to HTML (there is a rate limit – so don’t overdo it)</li>
<li>Caching support (so you can configure how often the file is being fetched from the source – default is a <strong>once per hour</strong> maximum)</li>
<li>Customise the CSS class of the markdown container to adjust styles</li>
</ul>
<h3>Instructions / Examples</h3>
<p>Download and unpack or clone this repository into your <code>wp-content/plugins</code> folder, so the PHP file resides in <code>wp-content/plugins/external-markdown/external-markdown.php</code>.</p>
<p>If you use the Guttenberg editor, you need to add a “Shortcode” block first. If your’re using the classic editor, you can use the shortcode right away.</p>
<h4>Simple embed</h4>
<p>The <code>url</code> parameter takes the URL to the Markdown file you want to embed. Make sure to <a href="#attention-when-using-github-gitlab-etc" rel="nofollow ugc">use the “raw” URL when you use GitHub, GitLab, etc</a>.<br />
    <code>[external_markdown url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]</code></p>
<h4>Adjust caching duration</h4>
<p>The <code>ttl</code> parameter controls how long the cached version is used, before it’s fetched again. The value is given in seconds. So 24 hours (24* 60 *60) result in a value of 86400.<br />
    <code>[external_markdown ttl=86400 url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]</code></p>
<h4>Adjust container CSS class</h4>
<p>The <code>class</code> parameter takes your desired class name for the external markdown container. The default class name for the container is <code>class='external-markdown'</code>.<br />
    <code>[external_markdown class="my-classname" url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]</code></p>
<h4>Attention when using GitHub, GitLab, etc.</h4>
<p>When embedding content from Git hosting services like GitHub or GitLab, you need to make sure to use the proper “raw” markdown URL. You can find this URL in the upper right corner of the web view.</p>
<h3>Attribution</h3>
<ul>
<li>This plugin was inspired by the great <a href="https://wordpress.org/plugins/documents-from-git/" rel="ugc">wordpress-markdown-git</a> plugin, which serves a similar purpose, but uses the Git provider APIs to fetch the raw Markdown files – which is a little more complicated than this approach here.</li>
</ul>


External Markdown

Working well

This is a plugin for Wordpress to embed Markdown files from external web sources (e.g. GitHub, GitLab, etc) into WordPress content.

Panegyric vs External Markdown