This chapter has important information for releases in it. If you’re upgrading from a previous release, please read it carefully, or at least skim over it.
This is a short, bugfix release.
Do this to upgrade
This release switches the default terms of service to be off by default and corrects some mistakes in the default terms of service.
Turning the terms of service on is very easy, just set show_tos in the [mediagoblin] section of your config to true.
Do this to upgrade
That’s it, probably! If you run into problems, don’t hesitate to contact us (IRC is often best).
This tool has a lot of new tools for administrators, hence the nickname “Lore of the Admin”!
New features:
New tools to control how much users can upload, both as a general user limit, or per file.
You can set this with the following options in your mediagoblin config file: upload_limit and max_file_size. Both are integers in megabytes.
There is an option to control how much each individual user can upload too, though an interface for this is not yet exposed. See the “uploaded” field on the core__users table.
MediaGoblin now contains an authentication plugin for ldap! You can turn on the mediagoblin.plugins.ldap plugin to make use of this. See the documentation: ldap plugin
There’s a new command line upload tool! At long last! See ./bin/gmg addmedia –help for info on how to use this.
There’s now a terms of service document included in MediaGoblin. It’s turned on by default, but you can turn it off if you prefer, just set the configuration option of show_tos in the [mediagoblin] section of your config to false.
Alternately, you can override the template for the terms of service document to set up your own.
We have a lot of new administrative tooling features! - There’s a built-in privileges/permissions system now.
Administrators are given access to modifying these parameters from a user administration panel.
New version of video.js is included with MediaGoblin. Slight amount of skinning to match the MediaGoblin look, otherwise also uses the new default skin.
Developer-oriented changes:
v0.5.1 is a bugfix release... the steps are the same as for 0.5.1.
Bugfixes:
NOTE: If using the API is important to you, we’re in a state of ransition towards a new API via the Pump API. As such, though the old API still probably works, some changes have happened to the way oauth works to make it more Pump-compatible. If you’re heavily using clients using the old API, you may wish to hold off on upgrading for now. Otherwise, jump in and have fun! :)
Do this to upgrade
Note that a couple of things have changed with mediagoblin.ini. First we have a new Authentication System. You need to add [[mediagoblin.plugins.basic_auth]] under the [plugins] section of your config file. Second, media types are now plugins, so you need to add each media type under the [plugins] section of your config file.
We have made a script to transition your mediagoblin_local.ini file for you. This script can be found at:
If you run into problems, don’t hesitate to contact us (IRC is often best).
New features
This is a bugfix release for 0.4.0. This only implements one major fix in the newly released document support which prevented the “conversion via libreoffice” feature.
If you were running 0.4.0 you can upgrade to v0.4.1 via a simple switch and restarting mediagoblin/celery with no other actions.
Otherwise, follow 0.4.0 instructions.
Do this to upgrade
Make sure to run ./bin/python setup.py develop --upgrade && ./bin/gmg dbupdate after upgrading.
See “For Theme authors” if you have a custom theme.
Note that ./bin/gmg theme assetlink is now just ./bin/gmg assetlink and covers both plugins and assets. Keep on reading to hear more about new plugin features.
If you want to take advantage of new plugins that have statically served assets, you are going to need to add the new “plugin_static” section to your nginx config. Basically the following for nginx:
# Plugin static files (usually symlinked in)
location /plugin_static/ {
alias /srv/mediagoblin.example.org/mediagoblin/user_dev/plugin_static/;
}
Similarly, if you’ve got a modified paste config, you may want to borrow the app:plugin_static section from the default paste.ini file.
We now use itsdangerous for sessions; if you had any references to beaker in your paste config you can remove them. Again, see the default paste.ini config
We also now use git submodules. Please do: git submodule init && git submodule update You will need to do this to use the new PDF support.
For theme authors
If you have your own theme or you have any “user modified templates”, please note the following:
New features
Do this to upgrade
Make sure to run bin/gmg dbupdate after upgrading.
OpenStreetMap is now a plugin, so if you want to use it, add the following to your config file:
[plugins]
[[mediagoblin.plugins.geolocation]]
If you have your own theme, you may need to make some adjustments to it as some theme related things may have changed in this release. If you run into problems, don’t hesitate to contact us (IRC is often best).
New features
New dropdown menu for accessing various features.
Significantly improved URL generation. Now mediagoblin won’t give up on making a slug if it looks like there will be a duplicate; it’ll try extra hard to generate a meaningful one instead.
Similarly, linking to an id no longer can possibly conflict with linking to a slug; /u/username/m/id:35/ is the kind of reference we now use to linking to entries with ids. However, old links with entries that linked to ids should work just fine with our migration. The only urls that might break in this release are ones using colons or equal signs.
New template hooks for plugin authoring.
As a demonstration of new template hooks for plugin authoring, openstreetmap support now moved to a plugin!
Method to add media to collections switched from icon of paperclip to button with “add to collection” text.
Bug where videos often failed to produce a proper thumbnail fixed!
Copying around files in MediaGoblin now much more efficient, doesn’t waste gobs of memory.
Video transcoding now optional for videos that meet certain criteria. By default, MediaGoblin will not transcode webm videos that are smaller in resolution than the MediaGoblin defaults, and MediaGoblin can also be configured to allow theora files to not be transcoded as well.
Per-user license preference option; always want your uploads to be BY-SA and tired of changing that field? You can now set your license preference in your user settings.
Video player now responsive; better for mobile!
You can now delete your account from the user preferences page if you so wish.
Other changes
This will be the last release that is capable of converting from an earlier MongoDB-based MediaGoblin instance to the newer SQL-based system.
Do this to upgrade
# directory of your mediagoblin install cd /srv/mediagoblin.example.org
# copy source for this release git fetch git checkout tags/v0.3.2
# perform any needed database updates bin/gmg dbupdate
# restart your servers however you do that, e.g., sudo service mediagoblin-paster restart sudo service mediagoblin-celeryd restart
New features
3d model support!
You can now upload STL and OBJ files and display them in MediaGoblin. Requires a recent-ish Blender; for details see: Deploying MediaGoblin
trim_whitespace
We bundle the optional plugin trim_whitespace which reduces the size of the delivered html output by reducing redundant whitespace.
See Part 2: Core plugin documentation for plugin documentation
A new API!
It isn’t well documented yet but we do have an API. There is an android application in progress which makes use of it, and there are some demo applications between automgtic, an automatic media uploader for your desktop and OMGMG, an example of a web application hooking up to the API.
This is a plugin, so you have to enable it in your mediagoblin config file by adding a section under [plugins] like:
[plugins]
[[mediagoblin.plugins.api]]
Note that the API works but is not nailed down... the way it is called may change in future releases.
OAuth login support
For applications that use OAuth to connect to the API.
This is a plugin, so you have to enable it in your mediagoblin config file by adding a section under [plugins] like:
[plugins]
[[mediagoblin.plugins.oauth]]
Collections
We now have user-curated collections support. These are arbitrary galleries that are customizable by users. You can add media to these by clicking on the paperclip icon when logged in and looking at a media entry.
OpenStreetMap licensing display improvements
More accurate display of OSM licensing, and less disruptive: you click to “expand” the display of said licensing.
Geolocation is also now on by default.
Miscelaneous visual improvements
We’ve made a number of small visual improvements including newer and nicer looking thumbnails and improved checkbox placement.
Do this to upgrade
New features
theming support
MediaGoblin now also includes theming support, which you can read about in the section Theming MediaGoblin.
flatpages
MediaGoblin has a flatpages plugin allowing you to add pages that are aren’t media-related like “About this site...”, “Terms of service...”, etc.
See Part 2: Core plugin documentation for plugin documentation
This release has one important change. You need to act when upgrading from a previous version!
This release changes the database system from MongoDB to SQL(alchemy). If you want to setup a fresh instance, just follow the instructions in the deployment chapter. If on the other hand you want to continue to use one instance, read on.
To convert your data from MongoDB to SQL(alchemy), you need to follow these steps:
Make sure your MongoDB is still running and has your data, it’s needed for the conversion.
Configure the sql_engine URI in the config to represent your target database (see: Deploying MediaGoblin)
You need an empty database.
Then run the following command:
bin/gmg [-cf mediagoblin_config.ini] convert_mongo_to_sql
Start your server and investigate.
That’s it.