Update readme.md
This commit is contained in:
1 parent
6efcb252e1
commit
db87a5d45f
1 file changed
+48
-16
@@ -1,58 +1,90 @@
|
|||||||
# This is my package laravel-cision-feed
|
# Laravel Cision Feed
|
||||||
|
|
||||||
[](https://packagist.org/packages/mattitjaab/laravel-cision-feed)
|
[](https://packagist.org/packages/mattitjaab/laravel-cision-feed)
|
||||||
[](https://github.com/mattitjaab/laravel-cision-feed/actions?query=workflow%3Arun-tests+branch%3Amain)
|
[](https://github.com/mattitjaab/laravel-cision-feed/actions?query=workflow%3Arun-tests+branch%3Amain)
|
||||||
[](https://github.com/mattitjaab/laravel-cision-feed/actions?query=workflow%3A"Fix+PHP+code+style+issues"+branch%3Amain)
|
[](https://github.com/mattitjaab/laravel-cision-feed/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)
|
||||||
[](https://packagist.org/packages/mattitjaab/laravel-cision-feed)
|
[](https://packagist.org/packages/mattitjaab/laravel-cision-feed)
|
||||||
|
|
||||||
This is where your description should go. Limit it to a paragraph or two. Consider adding a small example.
|
A Laravel package for retrieving and parsing data from [Cision News](https://news.cision.com/se). Fetch press releases, financial reports, media posts, and structured article content using a simple and expressive API.
|
||||||
|
|
||||||
## Support us
|
---
|
||||||
|
|
||||||
[<img src="https://github-ads.s3.eu-central-1.amazonaws.com/laravel-cision-feed.jpg?t=1" width="419px" />](https://spatie.be/github-ad-click/laravel-cision-feed)
|
## Features
|
||||||
|
|
||||||
We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us).
|
- Retrieve Cision RSS feeds by type (Press, News, Financial, Media)
|
||||||
|
- Parse article pages and extract clean structured HTML
|
||||||
|
- Automatically handles encoding, formatting, and clean-up of content
|
||||||
|
- Fully testable and extensible
|
||||||
|
|
||||||
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards).
|
---
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
You can install the package via composer:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
composer require mattitjaab/laravel-cision-feed
|
composer require mattitjaab/laravel-cision-feed
|
||||||
```
|
```
|
||||||
|
|
||||||
|
You may optionally set your Cision slug in your `.env`:
|
||||||
|
|
||||||
|
```
|
||||||
|
LARAVEL_CISION_FEED_SLUG=your-cision-slug
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
```php
|
```php
|
||||||
$cision = new Mattitja\Cision();
|
use Mattitja\Cision\Cision;
|
||||||
echo $cision->echoPhrase('Hello, Mattitja!');
|
|
||||||
|
$cision = new Cision();
|
||||||
|
|
||||||
|
// Fetch RSS entries
|
||||||
|
$items = $cision->press(); // or ->news(), ->financial(), ->media()
|
||||||
|
|
||||||
|
// Fetch full content for a specific article
|
||||||
|
$article = $cision->fetchContent('https://news.cision.com/se/example-company/r/your-article-slug,c1234567');
|
||||||
|
|
||||||
|
echo $article['header']; // Article headline
|
||||||
|
echo $article['published_at']; // ISO timestamp
|
||||||
|
echo $article['content']; // Clean HTML
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Testing
|
## Testing
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
composer test
|
composer test
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Changelog
|
## Changelog
|
||||||
|
|
||||||
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
|
See [CHANGELOG](CHANGELOG.md) for recent changes.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
|
Contributions are welcome! Please see [CONTRIBUTING](CONTRIBUTING.md) for guidelines.
|
||||||
|
|
||||||
## Security Vulnerabilities
|
---
|
||||||
|
|
||||||
Please review [our security policy](../../security/policy) on how to report security vulnerabilities.
|
## Security
|
||||||
|
|
||||||
|
If you discover any security-related issues, please refer to our [security policy](../../security/policy).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Credits
|
## Credits
|
||||||
|
|
||||||
- [Mattitja AB](https://github.com/MattitjaAB)
|
- [Mattitja AB](https://github.com/MattitjaAB)
|
||||||
- [All Contributors](../../contributors)
|
- [All Contributors](../../contributors)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
|
The MIT License (MIT). See [LICENSE](LICENSE.md) for details.
|
||||||
Reference in new issue
Block a user