Skip to content

Commit bc8d98c

Browse files
authored
Merge pull request #314 from Leinad4Mind/update-readme
Update readme
2 parents 9f98fbb + 6cc7521 commit bc8d98c

File tree

1 file changed

+83
-19
lines changed

1 file changed

+83
-19
lines changed

README.md

Lines changed: 83 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2,24 +2,26 @@
22

33
[![Tests](https://github.com/satanasov/phpbbgallery/actions/workflows/tests.yml/badge.svg)](https://github.com/satanasov/phpbbgallery/actions/workflows/tests.yml) [![Code Coverage](https://scrutinizer-ci.com/g/satanasov/phpbbgallery/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/satanasov/phpbbgallery/?branch=master) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/satanasov/phpbbgallery/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/satanasov/phpbbgallery/?branch=master)
44

5-
© 2012 - [nickvergessen](http://www.flying-bits.org)
5+
© 2008 - 2012 - [nickvergessen](https://web.archive.org/web/20131104154014/http://www.flying-bits.org/index.php)
66

7-
© 2014 - 2022 - [Lucifer](http://www.anavaro.com)
7+
© 2014 - 2025 - [Lucifer](https://www.anavaro.com)
8+
9+
© 2019 - 2025 [Leinad4Mind](https://leinad4mind.top/forum)
810

911
Welcome to phpBB Gallery version 3.3.x
1012

1113
This is direct port of [nickvergessen](https://github.com/nickvergessen)'s phpBB Gallery 1.1.6 for phpBB 3.0. As he has no time to support it or to port it, I have taken this on my self. The phpBB Gallery is very good project and I use it heavily. This is why I can't leave it and just wait for someone to port it or to create alternative.
1214

1315
This project will include only base core code and functioning add-ons which will expand this code.
1416

15-
##Donate
16-
If you like my code - buy me a beer/coffee/license for PhpStorm :D
17+
## Donate
18+
If you like this extension or just like my code - buy me a beer/coffee/license for PhpStorm :D
19+
20+
[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3JQ8HDK6Y7A2N)
1721

1822
- BTC: 12afvCTp1dRrQdHaavzthZ1dNWMoi8eyc8
1923
- ETH: 0x363abc8edf41ac89906b20e90cf7fdc71fe78cd5
2024

21-
[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XQ6USSXCSUM5W)
22-
2325
## Known Issues
2426

2527
MSSQL is not ok. I don't have a MSSQL instance to test different functions. If you want to use with MSSQL - we can debug and do stuff.
@@ -31,17 +33,85 @@ MSSQL is not ok. I don't have a MSSQL instance to test different functions. If y
3133

3234
### Exif
3335

34-
Allows saving and visualization of EXIF (Exchangeable image file format) image information. Basicly a bunch of stuff about the image - F-stop, ISO, appature, speed, usage of flash ... it could hold GPS coordinates ...
36+
Allows saving and visualization of EXIF (Exchangeable image file format) image information. Basically a bunch of stuff about the image - F-stop, ISO, aperture, speed, usage of flash... it could hold GPS coordinates...
3537

3638
### ACP Import
3739

3840
Allows bulk import of images.
3941

4042
### ACP cleanup
4143

42-
Bunch of functions related to DB and file system maintenence. Allows you to purge albums, move pictures, clean orphaned images, albums and comments ...
43-
44-
## Adding a new feture?
44+
Bunch of functions related to DB and file system maintenance. Allows you to purge albums, move pictures, clean orphaned images, albums and comments...
45+
46+
47+
## Current features (grabbed from 1.1.6 - To be reviewed)
48+
49+
### Configurations/Misc:
50+
- Filetypes: gif, jpg, jpeg, png & webp (new)
51+
- Imagesize: filesize, image-height, image-width
52+
- Resize images on upload
53+
- Global control about comment & rating system (dis-/enable)
54+
- Thumbnails: GD-version, quality and size
55+
- Images available in 3 sizes (thumbnail, medium, full)
56+
- Several options to thumbnail-displaying album.php: number of rows & columns, options to display (username, rating, comments, upload-time...)
57+
- RRC (recent-random-comment): display the recent images, random images and/or recent comments on the gallery/index.php with full ACP-Control
58+
- Sub-folder name adjustable (default: gallery/)
59+
- Search function (also available in the album) (page for Recent/Random/Top-Rated/Last comments/Own images)
60+
- Available in more languages: Bulgarian, Dutch, French, German and Russian
61+
- Available Addons: ACP Cleanup, ACP Import and EXIF
62+
63+
### Integration in phpBB:
64+
- Link to personal gallery on viewtopic (ACP-Option)
65+
- Number of user-images on viewtopic (ACP-Option)
66+
- Number of images on index (ACP-Option)
67+
- Recent/Random images in user-profile (with full ACP-Control)
68+
- BBcode to use gallery images in postings
69+
- Available for prosilver styles
70+
71+
### Album / Permission-management:
72+
- Unlimited sub... subalbums depth
73+
- Copy permissions on create/edit album
74+
- Album-types: Category, album, contest (see later for more information)
75+
- "Album locked"-Option
76+
- Inherit function on setting permissions
77+
- Group- & User-based permissions
78+
- Image-permissions: view, view without watermark, upload, upload with approval, edit, delete, report, rate
79+
- Comment-permissions: view, post, edit, delete
80+
- Moderate-permissions: moderate comments, image: delete, edit, move, handle reports, approve/lock
81+
- Misc-permissions: View album, Number of allowed images (also unlimited), albums (for personal galleries)
82+
- Personal galleries (upload by owner only), with subalbums and management through UCP
83+
84+
### Images / Comments:
85+
- Hotlink prevention: also with whitelist
86+
- Display exif-data
87+
- Watermark: with min-width and min-height, to avoid little images from being fully covered
88+
- Report function
89+
- Upload more images at once (Number settable in the ACP)
90+
- Full user-profile on comments
91+
- BBCodes, Custom-BBCodes and Smilies on comments & image-description
92+
- Notification (via notification only) on new images/comments/reports/approvals
93+
- Option to favorite images
94+
- Next/Previous link (with imagename and thumbnail)
95+
- Unread-markup of albums with new images
96+
97+
### ACP:
98+
- Statistical overview
99+
- Resync-Options for several dynamic values
100+
- Reset rating for album
101+
- Mass-Import (With Addon)
102+
- CleanUp (With Addon): Ability to delete images/comments of deleted users (or set to anonymous/guest), and personal albums
103+
104+
### Contests:
105+
- First timeperiod: Upload only, ratings and comments are not allowed, upload-username is hidden
106+
- Second timeperiod: No more upload, ratings are allowed, comments are not allowed, upload-username is hidden
107+
- End of contest: No more upload and ratings, comments are allowed, upload-username is displayed
108+
109+
### TODO
110+
111+
Make plugins work again [Highslide JS](https://highslide.com/download.php), [Shadowbox](https://www.shadowbox-js.com/download.html) and [Lytebox](https://web.archive.org/web/20130430051404/http://lytebox.com) support (These scripts must be downloaded separately because of the license) or maybe remove and add new ones.
112+
Points Ext. Compatibility (Addon)
113+
114+
## Adding a new feature?
45115

46116
If you can make me think of it as core function I will add it. Such function is going to be the contests, the plupload support and jQuery based visualization libraries.
47117

@@ -53,15 +123,15 @@ If you want to contribute to this project do it as you will any other project -
53123

54124
## Development roadmap?
55125

56-
As I said the 1.2 version will be primarly targeted as backword compatible with phpBB Gallery 1.1.6 MOD (DB will be the same but you will have to manualy move your images to the new location).
126+
As I said the 1.2 version will be primarily targeted as backwards compatible with phpBB Gallery 1.1.6 MOD (DB will be the same but you will have to manually move your images to the new location).
57127

58128
3.2.x is providing phpBB 3.2 compatibility and some code optimization. When initial release is done I will start adding features.
59129

60130
Version 3.3.x will be compatible to phpBB 3.3 and will have new features.
61131

62132
## Installation
63133

64-
This ext installs as evry other phpBB extension:
134+
This ext installs as every other phpBB extension:
65135

66136
- Clone the repo to ext folder OR download the zip file and copy phpbbgallery to your ext folder
67137
- Go to ACP -> Customise -> Manage extensions
@@ -75,10 +145,4 @@ This is task that could not be automated. You will have to do some work. Just fo
75145
Regards,
76146
Stanislav Atanasov
77147

78-
P.S.: You can get more support here - [Forum](http://lab.anavaro.com/forum/viewforum.php?f=4)
79-
80-
P.P.S: If you like this extension - you could alway donate:
81-
82-
[![alt text](http://lab.anavaro.com/forum/images/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3JQ8HDK6Y7A2N)
83-
84-
![alt text](http://www.xe.com/themes/xe/images/symbols/xbt.gif) 12afvCTp1dRrQdHaavzthZ1dNWMoi8eyc8
148+
P.S.: You can get more support here - [Forum](https://www.phpbb.com/customise/db/extension/phpbb_gallery/support)

0 commit comments

Comments
 (0)