Outils pour utilisateurs

Outils du site


php:shaarli

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
php:shaarli [2012/01/26 14:08] – [Features] sebsauvagephp:shaarli [2022/09/03 14:50] (Version actuelle) sebsauvage
Ligne 1: Ligne 1:
-{{:php:php_shaarli:php_shaarli_logo_wiki.png?nolink&|}}+{{:php:php_shaarli:php_shaarli_logo_inkscape_w600_whitebg-nq8.png?nolink&|}}
  
 You want to share the links you discover ? Shaarli is a minimalist delicious clone you can install on your own website. It is designed to be personal (single-user), fast and handy. You want to share the links you discover ? Shaarli is a minimalist delicious clone you can install on your own website. It is designed to be personal (single-user), fast and handy.
Ligne 6: Ligne 6:
  
   * Minimalist design (simple is beautiful)   * Minimalist design (simple is beautiful)
-  * **FAST**+  * FAST
   * Dead-simple installation: Drop the files, open the page. No database required.   * Dead-simple installation: Drop the files, open the page. No database required.
-  * Easy to use: Single button in your browser to bookmark a page+  * Easy to use: Single button in your browser to bookmark a page (There is also an [[https://play.google.com/store/apps/details?id=com.manatlan.tools.share|application]] for Android (Thanks to [[http://www.manatlan.com/blog/shaarli_on_the_play_store|Manatlan]]))
   * Save url, title, description (unlimited size). Classify links with tags (with autocomplete)   * Save url, title, description (unlimited size). Classify links with tags (with autocomplete)
-  * Automatic thumbnails for various services (imgur, imageshack.us, flickr, youtube, vimeo, dailymotion...) +  * Tag renaming, merging and deletion. 
-  * Save bookmarks as public or private+  * Automatic thumbnails for various services (imgur, imageshack.us, flickr, youtube, vimeo, dailymotion…) 
 +  * Automatic conversion of URLs to clickable links in descriptionsSupport for http/ftp/file/apt/magnet protocols
 +  * Save links as public or private 
 +  * 1-clic access to your private links/notes
   * Browse links by page, filter by tag or use the full text search engine   * Browse links by page, filter by tag or use the full text search engine
   * Permalinks (with QR-Code) for easy reference   * Permalinks (with QR-Code) for easy reference
 +  * RSS and ATOM feeds (which can be filtered by tag or text search)
   * Tag cloud   * Tag cloud
   * Picture wall (which can be filtered by tag or text search)   * Picture wall (which can be filtered by tag or text search)
-  * "Links of the dayNewspaper-like digest, browsable by day. +  * Links of the day” Newspaper-like digest, browsable by day. 
-  * RSS and ATOM feeds (which can be filtered by tag or text search)+  * “Daily” RSS feed: Get each day a digest of all new links.
   * [[https://code.google.com/p/pubsubhubbub/|PubSubHubbub]] protocol support   * [[https://code.google.com/p/pubsubhubbub/|PubSubHubbub]] protocol support
   * Easy backup (Data stored in a single file)   * Easy backup (Data stored in a single file)
   * Compact storage (1315 links stored in 150 kb)   * Compact storage (1315 links stored in 150 kb)
-  * Can import/export Netscape bookmarks (for import/export from/to Firefox, Opera, Chrome, Delicious...+  * Mobile browsers support 
-  * Automatic ban of IP address upon too many failed logins +  * Also works with javascript disabled 
-  * Protected against [[http://en.wikipedia.org/wiki/Cross-site_request_forgery|XSRF]], session cookie hijacking. +  * Can import/export Netscape bookmarks (for import/export from/to Firefox, Opera, Chrome, Delicious
-  * Automatic removal of annoying FeedBurner/Google FeedProxy parameters in URL (''?utm_source...''+  * Brute force protected login form 
-  * Shaarli is a bookmarking application, but you can use it for micro-blogging (like Twitter), a pastebin, an online notepad, etc.+  * Protected against XSRF, session cookie hijacking. 
 +  * Automatic removal of annoying FeedBurner/Google FeedProxy parameters in URL (?utm_source
 +  * Shaarli is a bookmarking application, but you can use it for micro-blogging (like Twitter), a pastebin, an online notepad, a snippet repository, etc.
   * You will be automatically notified by a discreet popup if a new version is available   * You will be automatically notified by a discreet popup if a new version is available
-  * Pages are customisable (using simple [[http://www.raintpl.com/|RainTPL]] templates) +  * Pages are easy to customize (using CSS and simple RainTPL templates) 
- +   
-Requires php 5.1 (php 5.2 required for autocomplete.)+Requires php 5.1
  
 ===== Screenshots ===== ===== Screenshots =====
Ligne 39: Ligne 45:
  
 ===== Online example ===== ===== Online example =====
-http://sebsauvage.net/links/ 
  
-Note that the admin interface is not available.+My own instance: https://sebsauvage.net/links/ 
 + 
 +(Note that the admin interface is not available.)
 ===== Download ===== ===== Download =====
  
-You can download Shaarli here: [[http://sebsauvage.net/files/shaarli_0.0.36beta.zip|shaarli_0.0.36beta.zip]]+<note>**Note:** I do not have enough time to maintain this project right now. You will find a more up-to-date fork of this project at https://github.com/shaarli/ShaarliPlease use this fork for requests/bug/latest updates...</note>
  
-( Static URL, points always to the latest version : http://sebsauvage.net/files/shaarli.zip )+  * **Latest version:** 
 +    * <del>https://github.com/sebsauvage/Shaarli/archive/master.zip</del> 
 +    * https://github.com/shaarli/Shaarli/archive/master.zip  ← //**Recommended** community maintained version, more up-to-date.//
 ===== Licence ===== ===== Licence =====
  
 Shaarli is under the [[http://www.opensource.org/licenses/zlib-license.php|zlib/libpng OSI licence]]. Shaarli is under the [[http://www.opensource.org/licenses/zlib-license.php|zlib/libpng OSI licence]].
  
 +===== Credits =====
 +
 +  * Developer & maintainer: [[https://sebsauvage.net/|sebsauvage]]
 +  * Shaarli visual design & logo : [[http://blog.idleman.fr/|idleman]]
 +  * Shaarli logo typeface: "Comic Andy" used with the kind permission of [[http://thatguynamedandy.com/|Andrew Polhill]].
 +  * Thanks to the many many people who contributed patches.
 ===== Installation ===== ===== Installation =====
  
Ligne 64: Ligne 79:
   * On **free.fr** : Don't forget to create a directory 'sessions' at the root of your webspace. Then rename the file to .php5 **or** create a file ''.htaccess'' in the directory where Shaarli is located containing:<code>php 1   * On **free.fr** : Don't forget to create a directory 'sessions' at the root of your webspace. Then rename the file to .php5 **or** create a file ''.htaccess'' in the directory where Shaarli is located containing:<code>php 1
 SetEnv PHP_VER 5</code> Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. SetEnv PHP_VER 5</code> Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing.
 +  * If you have an error such as: <code>Parse error: syntax error, unexpected '=', expecting '(' in /links/index.php on line 54</code> is means that your host is using php4, not php5.
   * On **1and1** : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP).   * On **1and1** : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP).
 +  * On hosts which forbid outgoing HTTP requests (such as free.fr), some thumbnails will not work.
   * Conclusion: Most php hosts are crap.   * Conclusion: Most php hosts are crap.
  
Ligne 77: Ligne 94:
  
 This bookmarklet button in compatible with Firefox, Opera, Chrome and Safari. This bookmarklet button in compatible with Firefox, Opera, Chrome and Safari.
 +Under Opera, you can't drag'n drop the button: You have to right-click on it and add a bookmark to your personal toolbar.
  
 ==== Sharing a link ==== ==== Sharing a link ====
Ligne 93: Ligne 111:
  
   * **Use Shaarli as a personal twitter**: Click "Add link" in the menu then press Enter: This will create an empty entry in Shaarli which points to itself. You can add title and your bable in description. Unlike twitter, you are not limited to 140 characters, and you are not mandated to use URL shortening services.   * **Use Shaarli as a personal twitter**: Click "Add link" in the menu then press Enter: This will create an empty entry in Shaarli which points to itself. You can add title and your bable in description. Unlike twitter, you are not limited to 140 characters, and you are not mandated to use URL shortening services.
-  * **Use Shaarli as a private pastebin/notepad**: Click "Add link" and press Enter. You can then paste your text in the description and save. You can use the fulltext search engine to find a note, and edit it later.+  * **Use Shaarli as a private pastebin/notepad**: Click "Add link"press Enter and check "Private". You can then paste your text in the description and save. You can use the fulltext search engine to find a note, and edit it later.
 ===== FAQ ===== ===== FAQ =====
  
Ligne 153: Ligne 171:
  
  
 +**If you want to disable the session cookie hijacking protection**, change the following line:
 +<code php>    if (empty($_SESSION['uid']) || $_SESSION['ip']!=allIPs() || time()>=$_SESSION['expires_on'])</code>
 +to
 +<code php>    if (empty($_SESSION['uid']) || time()>=$_SESSION['expires_on'])</code>
 ==== I have a problem ==== ==== I have a problem ====
  
Ligne 178: Ligne 200:
 ==== Why not use a real database ? Files are slow ! ==== ==== Why not use a real database ? Files are slow ! ====
  
-Do browsing [[http://sebsauvage.net/links/|this page]] feel slow ? Try browsing older pages, too. +Do browsing [[https://sebsauvage.net/links/|this page]] feel slow ? Try browsing older pages, too. 
  
-It's not slow at all, is it ? And don't forget the database contains more than 9200 links, and it's //on a shared host//, with 17000 visitors/day for my website alone. And it's still damn fast. Why ?+It's not slow at all, is it ? And don't forget the database contains more than 16000 links, and it's //on a shared host//, with 32000 visitors/day for my website alone. And it's still damn fast. Why ?
  
-The data file is only 1,5 Mb. It's read 99% of the time, and is probably already in the operation system disk cache. So generating a page involves no I/O at all most of the time.+The data file is only 3.7 Mb. It's read 99% of the time, and is probably already in the operation system disk cache. So generating a page involves no I/O at all most of the time.
 ===== Technical details ===== ===== Technical details =====
  
Ligne 234: Ligne 256:
     * **jquery-ui.min.js** : jQuery-UI javascript library.     * **jquery-ui.min.js** : jQuery-UI javascript library.
     * **jquery-MIT-LICENSE.txt**: jQuery license.     * **jquery-MIT-LICENSE.txt**: jQuery license.
 +    * **jquery.lazyload.min.js**: [[http://www.appelsiini.net/projects/lazyload|LazyLoad]] javascript library.
     * **rain.tpl.class.php** : RainTPL templating library.     * **rain.tpl.class.php** : RainTPL templating library.
   * **tpl/** : RainTPL templates for Shaarli. They are used to build the pages.   * **tpl/** : RainTPL templates for Shaarli. They are used to build the pages.
Ligne 240: Ligne 263:
     * **config.php** : Shaarli configuration (login, password, timezone, title...)     * **config.php** : Shaarli configuration (login, password, timezone, title...)
     * **datastore.php** : Your link database (compressed).     * **datastore.php** : Your link database (compressed).
-    * **ipband.php** : IP address ban system data.+    * **ipban.php** : IP address ban system data.
     * **lastupdatecheck.txt** : Update check timestamp file (used to check every 24 hours if a new version of Shaarli is available).     * **lastupdatecheck.txt** : Update check timestamp file (used to check every 24 hours if a new version of Shaarli is available).
     * **log.txt** : login/IPban log.     * **log.txt** : login/IPban log.
Ligne 256: Ligne 279:
 ===== Discussion ===== ===== Discussion =====
  
-You can discuss about Shaarli in [[php:shaarli:discussion|this page]].+If you have a bug report or a new feature suggestion, please add them in the [[https://github.com/sebsauvage/Shaarli/issues|GitHub issue tracker]]. 
 + 
 +Alternatively, you can find older discussions about Shaarli in [[php:shaarli:discussion|this page]] (This discussion is **closed**.)
php/shaarli.1327586900.txt.gz · Dernière modification : 2014/07/12 11:26 (modification externe)