aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: b427bec5d7128df2a77eb43645ee15807cd5086b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# Simple Microblog

A very simple PHP app that stores twitter-like status updates in a sqlite database. It also generates a JSON feed, that can be used as a source for the [micro.blog](https://micro.blog/) service. It is aimed at people who would like to host their own micro.blog, but want to avoid using Wordpress for it.

![a screenshot of the microblog app](https://user-images.githubusercontent.com/1279725/34184164-9567a4b2-e51e-11e7-9317-d737ef3423f0.png)

There is a timeline view of your own posts, as well as a simple 'compose post' page behind a login form. Right now, only a unique ID, the post content and creation timestamp are saved for each entry, so this is only suitable for one user. (Multiple users would each have to install in their own directories.)

The entire design is inside a single theme file [microblog.css](microblog.css) and can be modified easily. The site HTML is pretty straightforward and should be easy to style.

The app requires at least PHP 5.5 and was tested on 7.0

### Installation

- Copy the files to a directory on your webserver
- edit [config.php](config.php) and adjust the settings if you like (at least set a new password!)
- edit [.htaccess](.htaccess) and set `RewriteBase` to a path matching your installation directory
- optional: modify the theme file [microblog.css](microblog.css)

### To Do

- add a regular RSS or ATOM feed in addition to the JSON feed, for versatility and integration with other services and readers
- make interface adjustments to be able to delete status posts
- test whether the [ping function](http://help.micro.blog/2017/api-feeds/) actually works

### Support my work

The app is provided for free, but if you'd like to support what I do, please consider tipping.

[![Gittip](https://www.dropbox.com/s/23emy7ngeqdnrrc/logo_gittip.png?raw=1)](https://www.gittip.com/oelna/)  [![Flattr](https://www.dropbox.com/s/20legqru72ffddw/logo_flattr.png?raw=1)](https://flattr.com/submit/auto?user_id=oelna&url=https%3A%2F%2Fgithub.com%2Foelna%2Fmicroblog&title=microblog&language=en&tags=github&category=software)