undefinedoffset/silverstripe-codebank

Code Bank is a code snippet manager with syntax highlighting for multiple languages including C++, ActionScript, Flex, HTML and SQL to name a few. Code Bank also has a simple revision history with a compare viewer so you can see the changes side-by-side between two revisions.

Installs: 133

Dependents: 1

Suggesters: 0

Security: 0

Stars: 45

Watchers: 8

Forks: 14

Type:silverstripe-module

3.1.2 2016-08-13 16:25 UTC

This package is auto-updated.

Last update: 2024-03-29 01:23:01 UTC


README

Latest Stable Version Total Downloads Latest Unstable Version License Build Status

Code Bank is a code snippet manager with syntax highlighting for multiple languages including C++, ActionScript, Flex, HTML and SQL to name a few. Code Bank also has a simple revision history with a compare viewer so you can see the changes side-by-side between two revisions.

Requirements:

Installation (Module)

composer require undefinedoffset/silverstripe-codebank 3.*@stable

Manual Install (Module only)

  1. Download and extract the latest Code Bank module release from here http://programs.edchipman.ca/applications/code-bank/
  2. Extract the module archive to the root of your SilverStripe installation, opening the extracted folder should contain _config.php in the root along with other files/folders
  3. Hit http://{your domain}/{path to root of code bank server folder}/dev/build?flush=all in your browser
  4. You will now see a Code Bank option in the CMS Menu

Installation (Standalone)

  1. Download and extract the latest Code Bank release from here http://programs.edchipman.ca/applications/code-bank/
  2. Extract the Code Bank to a location on your SilverStripe compatible web server, you should now see a Code Bank folder and a framework folder among others
  3. Follow the installation instructions at http://doc.silverstripe.org/framework/en/installation/
  4. If the installer completes successfully you will now be able to use the remote server in Code Bank's desktop client. Just set the server path to be http://{your domain}/{path to root of code bank server folder}
  5. You should make sure that the SilverStripe installer removed the install files install.php, and install-frameworkmissing.html

Upgrading to new versions:

Module Only (with composer, recommended):

composer update --no-dev undefinedoffset/silverstripe-codebank
Module Only (without composer)
  1. Download the latest Code Bank release here http://programs.edchipman.ca/applications/code-bank/
  2. Extract the archive to into the same folder as your SilverStripe Framework
  3. Hit http://{your domain}/{path to root of code bank server folder}/dev/build?flush=all in your browser

Stand Alone (with composer, recommended)

composer update --no-dev
Stand Alone (without composer)
  1. Download and extract the latest Code Bank release from http://programs.edchipman.ca/applications/code-bank/ overwriting the Code Bank and themes folders
  2. Download and extact just the CodeBank, framework and themes folders replacing only those folders and their children
  3. Hit http://{your domain}/{path to root of code bank server folder}/dev/build?flush=all in your browser, then you may use Code Bank normally

Custom Languages with Brushes

Code Bank uses SyntaxHighlighter to highlight code snippets, to provide a language with syntax highlighting you must add to your yml configs the following then run dev/build?flush=all.

CodeBank:
    extra_languages:
        - Name: "Example Language" #Name of the language
          HighlightCode: "example" #Highlighter code
          FileName: "ex" #File extension
          Brush: "mysite/javascript/shBrushEx.js" #Relative Path to the snippet highlighter brush

Switching the search engine

By default Code Bank uses MySQL's fulltext searching and on databases like Postgres it uses a partial match filtering for searching both from the client and in the web interface. Code Bank provides support for switching the engine to Solr if you have the silverstripe/fulltextsearch installed and a Solr server available. You may switch the search engine by adding the following to your mysite/_config/config.yml after add flush=1 to the url to update the config cache.

CodeBank:
    snippet_search_engine: "SolrCodeBankSearchEngine"

Writing your own engine

Code Bank provides an api for you to hook in your own engine, you simply need to implement the ICodeBankSearchEngine interface and define the methods in the interface. The key thing to remember is that the doSnippetSearch() method takes 3 parameters the first $keyword, is the term/keyword the user is searching for (this maybe empty), the second ($langugeID) is the database ID of the language the user is filtering to. The last parameter ($folderID) is the ID of the folder the system is requesting matches for. The method itself should always return a SS_List subclass typically it should be DataList containing or pointing to only snippets. To enable your custom engine follow the steps above.

Attribution: