Commit | Line | Data |
---|---|---|
5be6425c E |
1 | .. MediaGoblin Documentation |
2 | ||
3 | Written in 2012 by MediaGoblin contributors | |
4 | ||
5 | To the extent possible under law, the author(s) have dedicated all | |
6 | copyright and related and neighboring rights to this software to | |
7 | the public domain worldwide. This software is distributed without | |
8 | any warranty. | |
9 | ||
10 | You should have received a copy of the CC0 Public Domain | |
11 | Dedication along with this software. If not, see | |
12 | <http://creativecommons.org/publicdomain/zero/1.0/>. | |
13 | ||
14 | ============= | |
15 | Release Notes | |
16 | ============= | |
17 | ||
18 | This chapter has important information for releases in it. | |
19 | If you're upgrading from a previous release, please read it | |
20 | carefully, or at least skim over it. | |
21 | ||
6e2dcbff | 22 | 0.3.3 |
8d19cb24 SS |
23 | ===== |
24 | ||
6e2dcbff CAW |
25 | **Do this to upgrade** |
26 | ||
27 | 1. Make sure to run ``bin/gmg dbupdate`` after upgrading. | |
28 | 2. OpenStreetMap is now a plugin, so if you want to use it, add the | |
29 | following to your config file:: | |
30 | ||
31 | [plugins] | |
32 | [[mediagoblin.plugins.geolocation]] | |
33 | ||
34 | If you have your own theme, you may need to make some adjustments to | |
a28c6c4c CAW |
35 | it as some theme related things may have changed in this release. If |
36 | you run into problems, don't hesitate to | |
37 | `contact us <http://mediagoblin.org/pages/join.html>`_ | |
38 | (IRC is often best). | |
6e2dcbff | 39 | |
8d19cb24 SS |
40 | **New features** |
41 | ||
6e2dcbff CAW |
42 | * New dropdown menu for accessing various features. |
43 | ||
44 | * Significantly improved URL generation. Now mediagoblin won't give | |
45 | up on making a slug if it looks like there will be a duplicate; | |
46 | it'll try extra hard to generate a meaningful one instead. | |
47 | ||
48 | Similarly, linking to an id no longer can possibly conflict with | |
49 | linking to a slug; /u/username/m/id:35/ is the kind of reference we | |
50 | now use to linking to entries with ids. However, old links with | |
51 | entries that linked to ids should work just fine with our migration. | |
52 | The only urls that might break in this release are ones using colons | |
53 | or equal signs. | |
54 | ||
55 | * New template hooks for plugin authoring. | |
56 | ||
57 | * As a demonstration of new template hooks for plugin authoring, | |
58 | openstreetmap support now moved to a plugin! | |
59 | ||
a28c6c4c CAW |
60 | * Method to add media to collections switched from icon of paperclip |
61 | to button with "add to collection" text. | |
6e2dcbff CAW |
62 | |
63 | * Bug where videos often failed to produce a proper thumbnail fixed! | |
64 | ||
fda5ea7a | 65 | * Copying around files in MediaGoblin now much more efficient, doesn't |
6e2dcbff CAW |
66 | waste gobs of memory. |
67 | ||
68 | * Video transcoding now optional for videos that meet certain | |
fda5ea7a CAW |
69 | criteria. By default, MediaGoblin will not transcode webm videos |
70 | that are smaller in resolution than the MediaGoblin defaults, and | |
71 | MediaGoblin can also be configured to allow theora files to not be | |
a28c6c4c | 72 | transcoded as well. |
6e2dcbff CAW |
73 | |
74 | * Per-user license preference option; always want your uploads to be | |
75 | BY-SA and tired of changing that field? You can now set your | |
76 | license preference in your user settings. | |
77 | ||
78 | * Video player now responsive; better for mobile! | |
79 | ||
70177c1f CAW |
80 | * You can now delete your account from the user preferences page if |
81 | you so wish. | |
82 | ||
a28c6c4c | 83 | **Other changes** |
8d19cb24 | 84 | |
b0c8328e SS |
85 | * Plugin writers: Internal restructuring led to mediagoblin.db.sql* be |
86 | mediagoblin.db.* starting from 0.3.3 | |
87 | ||
6e2dcbff CAW |
88 | * Dependency list has been reduced not requiring the "webob" package anymore. |
89 | ||
90 | * And many small fixes/improvements, too numerous to list! | |
91 | ||
8d19cb24 | 92 | |
cacb6fea SS |
93 | 0.3.2 |
94 | ===== | |
95 | ||
96 | This will be the last release that is capable of converting from an earlier | |
97 | MongoDB-based MediaGoblin instance to the newer SQL-based system. | |
98 | ||
1f01df1d CAW |
99 | **Do this to upgrade** |
100 | ||
5c99cd01 | 101 | 1. Make sure to run ``bin/gmg dbupdate`` after upgrading. |
1f01df1d | 102 | |
cacb6fea SS |
103 | |
104 | **New features** | |
105 | ||
1f01df1d CAW |
106 | * **3d model support!** |
107 | ||
108 | You can now upload STL and OBJ files and display them in | |
109 | MediaGoblin. Requires a recent-ish Blender; for details see: | |
110 | :ref:`deploying-chapter` | |
cacb6fea SS |
111 | |
112 | * **trim_whitespace** | |
113 | ||
114 | We bundle the optional plugin trim_whitespace which reduces the size | |
115 | of the delivered html output by reducing redundant whitespace. | |
116 | ||
117 | See :ref:`core-plugin-section` for plugin documentation | |
118 | ||
1f01df1d CAW |
119 | * **A new API!** |
120 | ||
121 | It isn't well documented yet but we do have an API. There is an | |
122 | `android application in progress <https://gitorious.org/mediagoblin/mediagoblin-android>`_ | |
123 | which makes use of it, and there are some demo applications between | |
124 | `automgtic <https://github.com/jwandborg/automgtic>`_, an | |
125 | automatic media uploader for your desktop | |
126 | and `OMGMG <https://github.com/jwandborg/omgmg>`_, an example of | |
127 | a web application hooking up to the API. | |
128 | ||
129 | This is a plugin, so you have to enable it in your mediagoblin | |
130 | config file by adding a section under [plugins] like:: | |
131 | ||
132 | [plugins] | |
133 | [[mediagoblin.plugins.api]] | |
134 | ||
135 | Note that the API works but is not nailed down... the way it is | |
136 | called may change in future releases. | |
137 | ||
138 | * **OAuth login support** | |
139 | ||
140 | For applications that use OAuth to connect to the API. | |
141 | ||
142 | This is a plugin, so you have to enable it in your mediagoblin | |
143 | config file by adding a section under [plugins] like:: | |
144 | ||
145 | [plugins] | |
146 | [[mediagoblin.plugins.oauth]] | |
147 | ||
148 | * **Collections** | |
149 | ||
150 | We now have user-curated collections support. These are arbitrary | |
151 | galleries that are customizable by users. You can add media to | |
152 | these by clicking on the paperclip icon when logged in and looking | |
153 | at a media entry. | |
154 | ||
155 | * **OpenStreetMap licensing display improvements** | |
156 | ||
157 | More accurate display of OSM licensing, and less disruptive: you | |
158 | click to "expand" the display of said licensing. | |
159 | ||
160 | Geolocation is also now on by default. | |
161 | ||
162 | * **Miscelaneous visual improvements** | |
163 | ||
164 | We've made a number of small visual improvements including newer and | |
165 | nicer looking thumbnails and improved checkbox placement. | |
166 | ||
167 | ||
5be6425c | 168 | |
3a438f5e WKG |
169 | 0.3.1 |
170 | ===== | |
171 | ||
9e579cde WKG |
172 | **Do this to upgrade** |
173 | ||
174 | 1. Make sure to run ``bin/gmg dbuptdate`` after upgrading. | |
175 | ||
176 | 2. If you set up your server config with an older version of | |
177 | mediagoblin and the mediagoblin docs, it's possible you don't | |
178 | have the "theme static files" alias, so double check to make | |
179 | sure that section is there if you are having problems. | |
180 | ||
181 | ||
182 | ||
183 | **New features** | |
184 | ||
185 | * **theming support** | |
186 | ||
187 | MediaGoblin now also includes theming support, which you can | |
188 | read about in the section :ref:`theming-chapter`. | |
189 | ||
190 | * **flatpages** | |
191 | ||
192 | MediaGoblin has a flatpages plugin allowing you to add pages that | |
193 | are aren't media-related like "About this site...", "Terms of | |
194 | service...", etc. | |
195 | ||
196 | See :ref:`core-plugin-section` for plugin documentation | |
3a438f5e WKG |
197 | |
198 | ||
6e930791 CAW |
199 | 0.3.0 |
200 | ===== | |
5be6425c E |
201 | |
202 | This release has one important change. You need to act when | |
203 | upgrading from a previous version! | |
204 | ||
205 | This release changes the database system from MongoDB to | |
206 | SQL(alchemy). If you want to setup a fresh instance, just | |
207 | follow the instructions in the deployment chapter. If on | |
208 | the other hand you want to continue to use one instance, | |
209 | read on. | |
210 | ||
dce37922 | 211 | To convert your data from MongoDB to SQL(alchemy), you need |
5be6425c E |
212 | to follow these steps: |
213 | ||
214 | 1. Make sure your MongoDB is still running and has your | |
215 | data, it's needed for the conversion. | |
216 | ||
abe74178 WKG |
217 | 2. Configure the ``sql_engine`` URI in the config to represent |
218 | your target database (see: :ref:`deploying-chapter`) | |
5be6425c E |
219 | |
220 | 3. You need an empty database. | |
221 | ||
222 | 4. Then run the following command:: | |
223 | ||
abe74178 | 224 | bin/gmg [-cf mediagoblin_config.ini] convert_mongo_to_sql |
5be6425c E |
225 | |
226 | 5. Start your server and investigate. | |
227 | ||
228 | 6. That's it. |